Sora 2

Создать видео Sora 2

Используйте POST /v1/videos, чтобы создавать задачи генерации видео Sora 2 из текстовых Prompt или референсных изображений, а затем опрашивать статус по ID задачи для получения результатов.

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Используйте этот endpoint, чтобы запустить задачу рендеринга Sora из текста или из текста плюс одного референсного изображения. API сразу возвращает video id и не ждет завершения рендеринга.

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

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

Длительность и размер

Параметр	Поддерживаемые значения	Стартовое значение по умолчанию	Поведение на границах
`seconds`	`4`, `8`, `12`, `16`, `20`	`4`	Другие значения не входят в схему запроса видео Sora.
`size` для `sora-2`	`1280x720`, `720x1280`	`1280x720`	Используйте альбомную или портретную ориентацию.
`size` для `sora-2-pro`	`1792x1024`, `1024x1792`, а также стандартные размеры Sora	`1792x1024` для альбомного вывода Pro	Используйте увеличенные размеры Pro только с моделью Pro.

Sora требует поле size в точном формате WxH. Токены разрешения, такие как 720p, и обозначения соотношения сторон, такие как 16:9, не являются допустимыми значениями size для Sora в этом endpoint.

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

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

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

Опрос до завершения задачи

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

Скачайте результат

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

Поведение 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 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

обязательно

string

обязательно

model

string

обязательно

object

string

обязательно

progress

integer

обязательно

seconds

string

обязательно

size

string

обязательно

status

string

обязательно

Скачать видеоконтент HappyHorse

Получение видео Sora 2

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Модерация контента

API-ключи

Создать видео Sora 2

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

Длительность и размер

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

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

Авторизации

Тело

Ответ

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

​Длительность и размер

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

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

Авторизации

Тело

Ответ

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

Длительность и размер

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

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