Перейти до основного вмісту
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 одразу повертає id відео і не чекає завершення рендерингу.

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

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

​
Наскрізний процес

1

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

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

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

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

Завантажте або переробіть результат

Коли рендеринг завершиться, отримайте файл через 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
обов'язково