Документация · Референс
Статус видео-задачи
GET/v1/videos/{video_id}
Возвращает video object и при необходимости опрашивает провайдера (poll-on-demand): статусы queued → in_progress → completed | failed, progress грубый (0/50/100 — у провайдеров нет точных процентов). Именно в момент перехода в completed происходит списание за генерацию. Принимает id и как video_<uuid>, и как голый uuid.
Авторизация — заголовок Authorization: Bearer <API-ключ>, base URL — https://api.trackly.one/v1.
Параметры пути
| Поле | Тип | Описание |
|---|---|---|
video_idобязательное | string | — |
Схема VideoObject
Video job object в формате Sora API.
| Поле | Тип | Описание |
|---|---|---|
completed_at | integer | null | — |
created_atобязательное | integer | — |
error | VideoErrorObject | null | — |
expires_at | integer | null | — |
idобязательное | string | — |
modelобязательное | string | — |
object | "video" | По умолчанию: "video" |
progressобязательное | integer | — |
promptобязательное | string | — |
secondsобязательное | string | — |
size | string | null | — |
statusобязательное | "queued" | "in_progress" | "completed" | "failed" | — |
Схема VideoErrorObject
| Поле | Тип | Описание |
|---|---|---|
codeобязательное | string | — |
messageобязательное | string | — |
Ответы
| Код | Описание | Схема |
|---|---|---|
200 | Успешный ответ | VideoObject |
422 | Ошибка валидации тела запроса или параметров | — |