Посібники з інтеграції
Помилки
Ціни та оплата
Офіційний API
Створення відео
Використовуйте POST /v1/videos, щоб створювати завдання генерації відео Sora 2 з текстових Prompt або референсних зображень, а потім опитувати статус за ID завдання для отримання результатів.
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, якщо вам не потрібен саме портретний формат - Завантажуйте не більше одного референсного зображення
Наскрізний процес
Створіть завдання рендерингу
Надішліть
model, prompt, seconds і size, а потім збережіть повернений id.Опитуйте, доки завдання не завершиться
Викликайте Retrieve Video, доки статус не стане
completed або failed.Завантажте або переробіть результат
Коли рендеринг завершиться, отримайте файл через Retrieve Video Content. Якщо вам потрібен цільовий варіант, використайте Remix Video для завершеного результату.
Поведінка Sora, яка все ще актуальна
OpenAI документує той самий процес create -> retrieve -> download у Videos API. У CometAPI ви зберігаєте структуру запиту Sora, але використовуєте base URL і ключ CometAPI. URL для завантаження готових результатів є тимчасовими, тож скопіюйте завершені assets у власне сховище, якщо вам потрібне тривале зберігання.Авторизації
Bearer token authentication. Use your CometAPI key.
Тіло
multipart/form-data
Text prompt that describes the video you want to create.
Приклад:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Приклад:
"sora-2"
Clip duration in seconds.
Доступні опції:
4, 8, 12 Приклад:
"4"
Output resolution formatted as width x height.
Доступні опції:
720x1280, 1280x720, 1024x1792, 1792x1024 Приклад:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
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"
}