Медиа-сессии

​

Сессия против задачи

​

Три последствия, о которых стоит знать заранее

1. Удалённая сессия прячет свои задачи. Они пропадают из списка, а GET, архив и восстановление по ним отдают 404. Сами записи задач при этом сохраняются.
2. Архивная сессия тоже прячет задачи из списка по умолчанию, но по идентификатору они остаются доступными и восстанавливаемыми. Архив обратим, удаление — нет.
3. Создавать задачу в архивной или удалённой сессии нельзя — вернётся 404.

​

Создать сессию

curl -X POST "https://speshu.ai/api/v1/media/sessions" \
  -H "Authorization: Bearer $SPESHU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Реклама для весны"}'

{ "code": 200, "msg": "success", "data": { "sessionId": "019...", "title": "Реклама для весны" } }

​

Список сессий

{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [
      { "sessionId": "019...", "title": "Реклама для весны", "createdAt": "2026-01-15T10:30:00Z" }
    ]
  }
}

​

Архивировать сессию

​

Удалить сессию

​

Определить длительность медиа

curl -X POST "https://speshu.ai/api/v1/media/probe-duration" \
  -H "Authorization: Bearer $SPESHU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/clip.mp4"}'

{ "code": 200, "msg": "success", "data": { "duration_seconds": 12.34 } }