Перейти к основному содержанию
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper airplane glides across a desk.' \
  --form input_reference='@example-file'
{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}
Используйте этот endpoint, чтобы запустить новую задачу рендеринга Sora из текста или из текста плюс одного референсного изображения. API сразу возвращает id видео и не ждёт завершения рендеринга.

Начните с минимально полезной задачи

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

Сквозной процесс

1

Создайте задачу рендеринга

Отправьте model, prompt, seconds и size, затем сохраните возвращённый id.
2

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

Вызывайте Retrieve Video, пока статус не станет completed или failed.
3

Скачайте результат или создайте remix

Когда рендеринг завершится, получите файл через Retrieve Video Content. Если вам нужна целевая вариация, используйте Remix Video для завершённого результата.

Поведение Sora, которое по-прежнему актуально

OpenAI документирует тот же процесс create -> retrieve -> download в Videos API. В CometAPI вы сохраняете формат запроса Sora, но используете base 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 a current model from the Models page.

Пример:

"sora-2"

seconds
enum<string>
по умолчанию:4

Clip duration in seconds.

Доступные опции:
4,
8,
12
Пример:

"4"

size
enum<string>
по умолчанию:1280x720

Output resolution formatted as width x height.

Доступные опции:
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
обязательно