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`
Перетворення зображення на відео	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Перетворення відео на відео	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

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

Анімуйте еталонне зображення

Для перетворення зображення на відео використовуйте model=omni-fast і завантажте один PNG-файл у поле multipart input_reference. Це поле залишається необов’язковим для перетворення тексту на відео, але є обов’язковим, коли еталонне зображення має визначати згенероване відео. У prompt зосередьтеся на русі, який потрібно додати, і явно вкажіть кольори, форми, об’єкти або композицію, які результат має зберегти. Селектор прикладів коду містить приклади для Shell, Python і JavaScript, які завантажують reference.png із робочого каталогу та створюють завдання. Ця структура запиту охоплює один завантажений PNG-файл. Вона не визначає введення через URL, інші формати зображень, кілька еталонних зображень або обмеження розміру файлу.

Редагуйте еталонне відео

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

Приклад:

"omni-fast"

prompt

string

обов'язково

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

Приклад:

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

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

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

Останнє оновлення 4 серпня 2026 р.

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 з тексту, зображення або відео

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

Анімуйте еталонне зображення

Редагуйте еталонне відео

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

Процес виконання завдання

Авторизації

Тіло

Відповідь

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

​Анімуйте еталонне зображення

​Редагуйте еталонне відео

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

​Процес виконання завдання

Авторизації

Тіло

Відповідь

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

Анімуйте еталонне зображення

Редагуйте еталонне відео

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

Процес виконання завдання