Skip to main content
POST
Використовуйте цей endpoint, щоб запустити завдання рендерингу Sora з тексту або з тексту плюс одного референсного зображення. API одразу повертає id відео й не чекає завершення рендерингу.

Почніть із найменшого корисного завдання

  • Використовуйте sora-2 для швидших ітерацій або sora-2-pro, коли якість результату важливіша за швидкість
  • Для першого запиту залиште seconds рівним 4
  • Починайте з size: 1280x720, якщо вам не потрібен саме портретний формат
  • Завантажуйте не більше одного референсного зображення

Тривалість і розмір

Sora вимагає, щоб поле size було в точному форматі WxH. Токени роздільної здатності, такі як 720p, і позначення співвідношення сторін, такі як 16:9, не є дійсними значеннями size для Sora в цьому endpoint.

Повний потік

1

Створіть завдання рендерингу

Надішліть model, prompt, seconds і size, а потім збережіть повернений id.
2

Опитуйте, доки завдання не завершиться

Викликайте Retrieve Video, доки статус не стане completed або failed.
3

Завантажте результат

Коли рендеринг завершиться, отримайте файл за допомогою Retrieve Video Content.

Поведінка Sora, яка все ще застосовується

OpenAI документує той самий потік create -> retrieve -> download у Videos API. У CometAPI ви зберігаєте форму запиту Sora, але використовуєте базовий URL і ключ CometAPI. Готові URL для завантаження є тимчасовими, тому копіюйте завершені ресурси у власне сховище, якщо вам потрібно довготривале зберігання.

Авторизації

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

Bearer token authentication. Use your CometAPI key.

Тіло

multipart/form-data
prompt
string
обов'язково

Text prompt that describes the video you want to create.

Приклад:

"A paper airplane glides across a desk."

model
string
за замовчуванням:sora-2

Sora model ID. Choose an available model from the Models page.

Приклад:

"sora-2"

seconds
enum<string>
за замовчуванням:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Доступні опції:
4,
8,
12,
16,
20
Приклад:

"4"

size
enum<string>
за замовчуванням:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Доступні опції:
720x1280,
1280x720,
1024x1792,
1792x1024
Приклад:

"1280x720"

input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

Відповідь

200 - application/json

Video job accepted.

created_at
integer
обов'язково
id
string
обов'язково
model
string
обов'язково
object
string
обов'язково
progress
integer
обов'язково
seconds
string
обов'язково
size
string
обов'язково
status
string
обов'язково