Skip to main content
GET
Використовуйте цей endpoint після запуску завдання Sora. Він повідомляє поточний стан завдання, налаштовані розмір і тривалість, а також будь-яку помилку, яку повернув провайдер.

​
Слідкуйте за цими полями

  • status для стану життєвого циклу
  • progress для грубого сигналу про прогрес
  • error, коли провайдер відхиляє завдання або під час його збою
  • expires_at після завершення, якщо вам потрібно знати, коли спливає строк дії тимчасових ресурсів

​
Опитуйте до завершення

1

Спочатку створіть відео

Почніть із Create Video.
2

Опитування за id

Передайте сюди повернений id і продовжуйте перевіряти, доки завдання не досягне completed або failed.
3

Завантажте файл

Коли завдання має стан completed, перейдіть до Retrieve Video Content.

​
Форма відповіді в CometAPI

Цей крок тісно відповідає workflow опитування Sora. CometAPI зберігає форму об’єкта у стилі OpenAI, тож ви можете налаштувати перевірки статусу з мінімальною адаптацією.

Авторизації

​
Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Параметри шляху

​
video_id
string
обов'язково

Video id returned by the create or remix endpoint.

Відповідь

200 - application/json

Current job state.

​
id
string
обов'язково

Task id.

​
size
string
обов'язково
​
model
string
обов'язково
​
object
string
обов'язково
​
status
string
обов'язково

Task state: queued, in_progress, completed, or failed.

​
seconds
string
обов'язково
​
progress
integer
обов'язково

Render progress from 0 to 100.

​
created_at
integer
обов'язково

Unix timestamp of task creation.

​
error
object | null
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null

Unix timestamp of completion.

​
remixed_from_video_id
string | null
​
video_url
string

Time-limited download URL present when status is completed. Mirror the file to your own storage for long retention.