Skip to main content
POST
cURL
Используйте этот beta-эндпоинт, чтобы создать задачу видео Omni. API сразу возвращает ID задачи, поэтому сохраните возвращённый id и опрашивайте задачу, пока она не достигнет конечного статуса. Beta POST /v1/videos использует multipart/form-data; передавайте скалярные параметры управления как поля формы.

Выберите режим ввода

Используйте model=omni-fast для этой страницы.

Задайте длительность, соотношение сторон и разрешение

Omni помечен как beta, потому что стабильность генерации может различаться в зависимости от входных данных и выбранного маршрута. Сделайте первый запрос небольшим, затем проверьте готовое видео, прежде чем полагаться на конкретную длительность рендера или размер кадра. Поскольку этот эндпоинт находится в beta, рассматривайте aspect_ratio и resolution как предпочтения генерации и проверяйте скачанный MP4, прежде чем полагаться на итоговые пиксели.

Поток задачи

1

Создать задачу

Отправьте multipart form-запрос и сохраните возвращённый id.
2

Опросить задачу

Вызывайте Retrieve an Omni video, пока status не станет completed или failed.
3

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

Когда задача получит статус completed, вызовите Retrieve Omni video content, чтобы скачать MP4-файл.

Авторизации

Authorization
string
header
обязательно

Bearer authentication. Use your CometAPI API key.

Тело

multipart/form-data
model
enum<string>
обязательно

Omni model ID for this endpoint. Use omni-fast for text-to-video.

Доступные опции:
omni-fast
Пример:

"omni-fast"

prompt
string
обязательно

Text prompt that describes the video to generate.

Пример:

"Ocean waves rolling onto a sandy beach at golden hour"

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

Requested clip duration in seconds. Start with 4 while this endpoint is beta.

Пример:

"4"

aspect_ratio
enum<string>
по умолчанию:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Доступные опции:
16:9,
9:16,
1:1
Пример:

"16:9"

resolution
string

Output resolution preference. Start with 720p. 1080p can be accepted but current production output may normalize to 720p.

Пример:

"720p"

Ответ

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_id}.

id
string
обязательно

Task ID. Use this value with retrieve and content endpoints.

Пример:

"task_example"

object
string
обязательно

Object type. Video tasks return video.

Пример:

"video"

model
string
обязательно

Model ID used for the task.

Пример:

"omni-fast"

status
enum<string>
обязательно

Task lifecycle status. Poll until the value is completed, failed, or error.

Доступные опции:
queued,
in_progress,
completed,
failed,
error
Пример:

"queued"

progress
integer
обязательно

Task progress as a coarse percentage.

Требуемый диапазон: 0 <= x <= 100
Пример:

0

created_at
integer
обязательно

Task creation time as a Unix timestamp in seconds.

Пример:

1779938152

task_id
string

Compatibility alias for id when present.

Пример:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Пример:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

Пример:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.