Перейти к основному содержанию
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Используйте этот endpoint, чтобы запустить новую задачу рендеринга Sora из текста или из текста плюс одного эталонного изображения. API сразу возвращает video 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 для скачивания временные, поэтому сохраняйте завершённые assets в собственное хранилище, если вам нужно длительное хранение.

Авторизации

​
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
обязательно