Документация · Референс

Список видео-задач

GET/v1/videos

Видео-задачи текущего API-ключа (точнее — его владельца), новые первыми. Пагинация курсором: after — id последнего видео предыдущей страницы, limit — до 100. Список не опрашивает провайдера — статус конкретной задачи продвигается только запросом GET /v1/videos/{id}.

Авторизация — заголовок Authorization: Bearer <API-ключ>, base URL — https://api.trackly.one/v1.

Query-параметры

Поле	Тип	Описание
`limit`	`integer`	По умолчанию: `20`
`after`	`string \| null`	—

Схема `VideoListResponse`

Поле	Тип	Описание
`data`обязательное	`array<VideoObject>`	—
`has_more`	`boolean`	По умолчанию: `false`
`object`	`"list"`	По умолчанию: `"list"`

Схема `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`	Успешный ответ	`VideoListResponse`
`422`	Ошибка валидации тела запроса или параметров	—

from openai import OpenAI client = OpenAI( api_key="sk-aiagg-...", base_url="https://api.trackly.one/v1", ) page = client.videos.list(limit=5) for video in page.data: print(video.id, video.status, video.prompt[:40]) if page.has_more: # следующая страница — курсор after next_page = client.videos.list(limit=5, after=page.data[-1].id)

import OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-aiagg-...", baseURL: "https://api.trackly.one/v1", }); const page = await client.videos.list({ limit: 5 }); for (const video of page.data) { console.log(video.id, video.status, video.prompt.slice(0, 40)); } // следующая страница — курсор after if (page.has_more) { const nextPage = await client.videos.list({ limit: 5, after: page.data.at(-1).id, }); }

{ "object": "list", "data": [ { "id": "video_8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d", "object": "video", "model": "google/veo-3.1", "status": "in_progress", "progress": 50, "created_at": 1752397100, "seconds": "6", "size": "720x1280", "prompt": "Капли дождя стекают по стеклу кофейни, макросъёмка" }, { "id": "video_5f2c1d8e-3a4b-4c5d-8e9f-0a1b2c3d4e5f", "object": "video", "model": "google/veo-3.1-fast", "status": "completed", "progress": 100, "created_at": 1752396600, "completed_at": 1752396744, "seconds": "8", "size": "1280x720", "prompt": "Дрон летит над зимним лесом на рассвете, мягкий свет" } ], "has_more": false }

Query-параметры

Схема VideoListResponse

Схема VideoObject

Схема VideoErrorObject

Ответы

Схема `VideoListResponse`

Схема `VideoObject`

Схема `VideoErrorObject`