API генерації відео

Опишіть ролик звичайними словами, виберіть модель, тривалість і формат кадру та отримайте файл MP4 зі звуковою доріжкою. OmevAI сам планує кадри й рух камери за вашим описом; ви обираєте лише те, що перелічено нижче. Ціна відома до запуску, а платите ви лише за ролик, який отримали.

Доступ вмикається на запит

API відео вмикається для кожного ключа окремо. Щоб його увімкнути, напишіть на support@omev.be. Ті самі моделі доступні у вебкабінеті, див. Генерація відео у кабінеті.

Відео працює асинхронно: створіть завдання, перевіряйте його статус, завантажте готовий файл. Усі виклики йдуть на звичний хост https://llmapi.omev.be з вашим API-ключем OmevAI.

Моделі та ціни

`model`	Найкраще підходить для	Тривалість	`resolution`	Що можна надіслати	Ціна за секунду
`omev-video-lite`	простих сцен за низькою ціною	4–12 с	`768p`	текст; текст і перший кадр	$0.039
`omev-video`	людей, складного руху, руху камери, кількох дій	4–15 с	`720p` (за замовчуванням), `1080p`	текст; текст і перший кадр	720p $0.069 · 1080p $0.135
`omev-video-premium`	преміальної якості, роликів до 30 с	4–30 с	`720p` (за замовчуванням), `1080p`	текст; текст і перший кадр; текст і до 5 референсних зображень	текст або перший кадр: 720p $0.075 · 1080p $0.15; з референсними зображеннями: 720p $0.11 · 1080p $0.22

Формати кадру (aspect_ratio): omev-video-lite приймає 16:9, 21:9, 4:3, 1:1, 3:4, 9:16; omev-video та omev-video-premium приймають 16:9, 4:3, 1:1, 3:4, 9:16.

Ціна ролика — це ціна за секунду, помножена на замовлену тривалість. 8-секундний ролик omev-video у 720p коштує 8 × $0.069 = $0.552, у 1080p — $1.08. 8-секундний ролик omev-video-premium у 720p коштує $0.60 за текстом або першим кадром і $0.88 з референсними зображеннями.

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

curl -sS https://llmapi.omev.be/v1/videos/generations \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omev-video",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "prompt": "A ceramic mug on a wooden table in morning light, the camera slowly circles the mug",
    "idempotency_key": "order-2026-10-12-0001"
  }'

Поле	Обов'язкове	Значення
`model`	так	`omev-video-lite`, `omev-video` або `omev-video-premium`
`prompt`	так	опис ролика, до 4 000 символів
`duration`	так	ціле число секунд у межах діапазону моделі
`aspect_ratio`	ні	формат кадру, який приймає модель, за замовчуванням `16:9`
`resolution`	ні	`720p` або `1080p` для `omev-video` та `omev-video-premium`; `omev-video-lite` завжди `768p`
`image`	ні	публічне посилання `https` на перший кадр (усі три моделі); воно має відкриватися без входу в обліковий запис
`references`	ні	до 5 публічних посилань `https` на референсні зображення: персонаж, продукт, логотип або стиль; лише `omev-video-premium` і не разом з `image`
`idempotency_key`	рекомендовано	ваш власний номер замовлення, до 100 символів; повтор із ним повертає те саме завдання й не списує кошти вдруге

seed, fps, steps, cfg і provider не приймаються (400): їх обирає OmevAI.

Відповідь — 202 із завданням:

{
  "id": "vid_0f3c2a9e8b7d4c6a1e5f2b3c",
  "object": "video.generation",
  "model": "omev-video",
  "status": "queued",
  "duration": 8,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "price_usd": 0.552,
  "access_token": "…"
}

Перед стартом завдання ціна резервується на балансі ключа. Коли ролик отримано, вона списується; якщо генерація не вдалася, резерв звільняється. Збережіть id і access_token: токен потрібен, щоб читати статус і завантажувати файл. Якщо відповідь загубилася, надішліть той самий запит із тим самим idempotency_key, щоб отримати ті самі id і токен.

2. Перевірте статус

curl -sS https://llmapi.omev.be/v1/videos/generations/$ID \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "X-Omev-Video-Token: $TOKEN"

Без токена або з токеном іншого завдання відповідь буде 404. Опитуйте кожні 10–15 секунд.

`status`	Значення
`queued`, `preprocessing`	завдання прийнято, опис перетворюється на план кадрів
`generating`	ролик створюється; `phase` показує `provider_queued` (очікування вільного місця), `generating` або `saving`
`processing`	рідкісна додаткова перевірка з нашого боку; продовжуйте опитування
`succeeded`	готово: `video.url` — посилання для завантаження
`failed`	не вдалося: `error.code` і `error.message` пояснюють причину; резерв звільнено

3. Завантажте ролик

curl -sS -L -o clip.mp4 https://llmapi.omev.be/v1/videos/generations/$ID/content \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "X-Omev-Video-Token: $TOKEN"

Відповідь — файл MP4 зі звуковою доріжкою. Завантажте його одразу після успішного завершення завдання і зберігайте у власному сховищі.

Повний цикл на Python

import os, time, requests

BASE = "https://llmapi.omev.be"
auth = {"Authorization": f"Bearer {os.environ['OMEV_API_KEY']}"}

job = requests.post(f"{BASE}/v1/videos/generations", headers=auth, timeout=60, json={
    "model": "omev-video-lite", "duration": 6, "aspect_ratio": "1:1",
    "prompt": "A cup of hot coffee, steam rising, soft light",
    "idempotency_key": "order-0002"}).json()

read = {**auth, "X-Omev-Video-Token": job["access_token"]}
while True:
    status = requests.get(f"{BASE}/v1/videos/generations/{job['id']}", headers=read, timeout=60).json()
    if status["status"] in ("succeeded", "failed"):
        break
    time.sleep(15)

if status["status"] == "succeeded":
    clip = requests.get(f"{BASE}{status['video']['url']}", headers=read, timeout=600)
    open("clip.mp4", "wb").write(clip.content)
else:
    print(status["error"])

Безкоштовні довідкові запити

GET /v1/videos/models: моделі з їхніми тривалостями, роздільністю, форматами кадру та цінами за секунду.
GET /v1/videos/price?model=omev-video&duration=8&resolution=1080p: ціна одного ролика, наприклад {"price_usd": 1.08, "per_second_usd": 0.135, …}. Для omev-video-premium з референсними зображеннями додайте &references=1.

Час і обмеження

4-секундний ролик зазвичай готується приблизно за 2 хвилини з omev-video-lite та omev-video-premium і за 10–20 секунд з omev-video. Довші ролики займають більше часу.
В обліковому записі одночасно може бути до 2 незавершених відеозавдань; третє отримає відповідь 429.
Повторна генерація та оцінювання ролика доступні у вебкабінеті. Через API для нової спроби створіть нове завдання.
Запити, що порушують політику щодо вмісту, відхиляються до будь-якого списання.

Помилки

Код	Значення	Що робити
`400`	тривалість поза діапазоном моделі, формат кадру або роздільність, які модель не приймає, перший кадр разом із референсними зображеннями, референсні зображення для моделі, відмінної від `omev-video-premium`, або параметр, який не приймається	виправте запит за `error.message`
`401`	API-ключ відсутній або недійсний	перевірте ключ
`402`	баланс ключа менший за ціну ролика	поповніть баланс
`403`	відео не ввімкнено для ключа	напишіть до служби підтримки
`404`	невідоме завдання або відсутній чи неправильний `X-Omev-Video-Token`	перевірте id і токен
`409`	`idempotency_key` уже використано з іншими параметрами, або комбінація тимчасово недоступна	використайте новий номер замовлення; якщо комбінація недоступна, повторіть пізніше
`429`	уже виконуються 2 відеозавдання	дочекайтеся завершення одного з них
`5xx`	тимчасова помилка	повторіть із тим самим `idempotency_key` через 10–30 секунд

Загальний формат описано на сторінці Помилки та повторні спроби.

Моделі та ціни​

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

2. Перевірте статус​

3. Завантажте ролик​

Повний цикл на Python​

Безкоштовні довідкові запити​

Час і обмеження​

Помилки​