Посібники з інтеграції
Помилки
Ціни та оплата
Офіційний API
Отримання відео
Використовуйте CometAPI GET /v1/videos/, щоб отримати статус відео Sora 2, прогрес і метадані, як-от тривалість, розміри, часові мітки та час завершення дії.
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}Використовуйте цей endpoint після запуску завдання Sora. Він повідомляє поточний стан завдання, налаштовані розмір і тривалість, а також будь-яку помилку, повернуту провайдером.
Зверніть увагу на ці поля
statusдля стану життєвого циклуprogressдля приблизного сигналу про прогресerrorколи провайдер відхиляє завдання або під час його виконання стається помилкаexpires_atпісля завершення, якщо вам потрібно знати, коли тимчасові ресурси втратять чинність
Опитуйте до завершення
Спочатку створіть або реміксуйте відео
Почніть із Create Video або Remix Video.
Опитування за id
Передайте сюди повернений
id і продовжуйте перевіряти, доки завдання не досягне стану completed або failed.Завантажте файл
Коли завдання матиме стан
completed, перейдіть до Retrieve Video Content.Форма відповіді в CometAPI
Цей крок тісно відповідає workflow опитування Sora. CometAPI зберігає форму об’єкта у стилі OpenAI, тож ви можете налаштувати перевірки статусу з мінімальною адаптацією.Авторизації
Bearer token authentication. Use your CometAPI key.
Параметри шляху
Video id returned by the create or remix endpoint.
Відповідь
200 - application/json
Current job state.
⌘I
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}