Omni

Створення відео Omni

Створіть бета-завдання Omni для перетворення тексту на відео або редагування референсного відео через CometAPI за допомогою POST /v1/videos, потім опитуйте завдання та завантажте готовий файл MP4.

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Використовуйте цей бета-ендпоїнт, щоб створити завдання перетворення тексту на відео або відео на відео. API одразу повертає ID завдання, тому збережіть повернуте значення id та опитуйте завдання, доки воно не досягне кінцевого статусу. Виберіть тип вмісту запиту, що відповідає режиму введення. Надсилайте параметри перетворення тексту на відео як поля multipart/form-data. Надсилайте редагування референсного відео як тіло application/json.

Виберіть режим введення

Мета	Тип вмісту	Обов’язкові поля	Необов’язкові поля
Перетворення тексту на відео	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Перетворення відео на відео	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

У прикладах перетворення тексту на відео використовується model=omni-fast. У прикладах перетворення відео на відео використовується model=omni-fast-v2v. Використовуйте Перегляд доступних моделей щоб підтвердити, що ID моделі доступний для вашого API key.

Редагування референсного відео

Для перетворення відео на відео закодуйте локальний файл MP4 у base64 і додайте до закодованих байтів префікс data:video/mp4;base64,. Надішліть повну data URL у полі video. Опишіть запитані зміни в prompt. Також укажіть суб’єкти, об’єкти, композицію або рух, які має зберегти результат. Селектор прикладів коду містить приклади Shell, Python і JavaScript, які зчитують reference.mp4 з робочого каталогу. Ця структура запиту охоплює вбудовану data URL для MP4. Вона не визначає введення URL, інші формати контейнерів відео або обмеження розміру файлу.

Установлення тривалості, співвідношення сторін і роздільної здатності

Omni позначено як бета-версію, оскільки стабільність генерації може відрізнятися залежно від введених даних і вибраного маршруту. Зробіть перший запит невеликим, а потім перевірте готове відео, перш ніж покладатися на певну відрендерену тривалість або розмір кадру.

Параметр	Підтримувані значення	За замовчуванням	Поведінка на межах
`seconds`	Почніть із `4`	Залежить від маршруту	Розглядайте це як запитувану тривалість і перевіряйте готовий MP4, оскільки тривалість результату може відрізнятися.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` може рендерити портретний результат. `1:1` може прийматися під час рендерингу в ландшафтній орієнтації.
`resolution`	Почніть із `720p`; `1080p` може прийматися	`720p`	Поточний результат у production може нормалізуватися до `720p`, навіть якщо запитується `1080p`.

Запит	Спостережуваний кадр готового відео
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Оскільки цей ендпоїнт є бета-версією, розглядайте aspect_ratio і resolution як налаштування генерації та перевіряйте завантажений MP4, перш ніж покладатися на остаточні пікселі.

Потік завдання

Створіть завдання

Надішліть запит із типом вмісту для вибраного режиму введення та збережіть повернуте значення id.

Опитуйте завдання

Викличте Отримання відео Omni доки значення status не стане completed або failed.

Завантажте результат

Коли завдання має статус completed, викличте Отримання вмісту відео Omni щоб завантажити файл MP4.

Авторизації

Authorization

string

header

обов'язково

Bearer authentication. Use your CometAPI API key.

Тіло

model

string

обов'язково

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

Приклад:

"omni-fast"

prompt

string

обов'язково

Text prompt that describes the video to generate.

Приклад:

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

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Приклад:

"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. A request for 1080p can render at 720p.

Приклад:

"720p"

Відповідь

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_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.

Show child attributes

Завантаження відеоконтенту Vidu

Попередня

Отримати Omni video

Наступна

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Модерація контенту

API-ключі

Створення відео Omni

Виберіть режим введення

Редагування референсного відео

Установлення тривалості, співвідношення сторін і роздільної здатності

Потік завдання

Авторизації

Тіло

Відповідь

​Виберіть режим введення

​Редагування референсного відео

​Установлення тривалості, співвідношення сторін і роздільної здатності

​Потік завдання

Авторизації

Тіло

Відповідь

Виберіть режим введення

Редагування референсного відео

Установлення тривалості, співвідношення сторін і роздільної здатності

Потік завдання