API generowania wideo

Opisz klip zwykłymi słowami, wybierz model, czas trwania i format kadru, a otrzymasz plik MP4 ze ścieżką dźwiękową. OmevAI planuje ujęcia i ruch kamery na podstawie Twojego opisu; Ty wybierasz tylko to, co jest wymienione poniżej. Cena jest znana przed rozpoczęciem, a płacisz tylko za klip, który zostanie dostarczony.

Dostęp jest włączany na życzenie

API wideo jest włączane dla każdego klucza osobno. Napisz na support@omev.be, aby je włączyć. Te same modele są dostępne w panelu internetowym, zobacz Generowanie wideo w panelu.

Wideo działa asynchronicznie: utwórz zadanie, sprawdzaj jego status, pobierz gotowy plik. Wszystkie wywołania korzystają ze zwykłego hosta https://llmapi.omev.be i Twojego klucza API OmevAI.

Modele i ceny

`model`	Najlepszy do	Czas trwania	`resolution`	Co możesz wysłać	Cena za sekundę
`omev-video-lite`	prostych scen, niska cena	4–12 s	`768p`	tekst; tekst i pierwszą klatkę	$0.039
`omev-video`	ludzi, złożonego ruchu, ruchu kamery, kilku akcji	4–15 s	`720p` (domyślnie), `1080p`	tekst; tekst i pierwszą klatkę	720p $0.069 · 1080p $0.135
`omev-video-premium`	jakości premium, klipów do 30 s	4–30 s	`720p` (domyślnie), `1080p`	tekst; tekst i pierwszą klatkę; tekst i do 5 obrazów referencyjnych	tekst lub pierwsza klatka: 720p $0.075 · 1080p $0.15; z obrazami referencyjnymi: 720p $0.11 · 1080p $0.22

Formaty kadru (aspect_ratio): omev-video-lite przyjmuje 16:9, 21:9, 4:3, 1:1, 3:4, 9:16; omev-video i omev-video-premium przyjmują 16:9, 4:3, 1:1, 3:4, 9:16.

Cena klipu to cena za sekundę pomnożona przez zamówiony czas trwania. 8-sekundowy klip omev-video w 720p kosztuje 8 × $0.069 = $0.552, w 1080p $1.08. 8-sekundowy klip omev-video-premium w 720p kosztuje $0.60 z tekstu lub pierwszej klatki i $0.88 z obrazami referencyjnymi.

1. Utwórz zadanie

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"
  }'

Pole	Wymagane	Wartości
`model`	tak	`omev-video-lite`, `omev-video` lub `omev-video-premium`
`prompt`	tak	opis klipu, do 4 000 znaków
`duration`	tak	pełne sekundy w zakresie modelu
`aspect_ratio`	nie	format kadru obsługiwany przez model, domyślnie `16:9`
`resolution`	nie	`720p` lub `1080p` dla `omev-video` i `omev-video-premium`; `omev-video-lite` ma zawsze `768p`
`image`	nie	publiczny link `https` do pierwszej klatki (wszystkie trzy modele); musi otwierać się bez logowania
`references`	nie	do 5 publicznych linków `https` do obrazów referencyjnych: postać, produkt, logo lub styl; tylko `omev-video-premium` i nie razem z `image`
`idempotency_key`	zalecane	Twój własny numer zamówienia, do 100 znaków; ponowne użycie zwraca to samo zadanie i nie pobiera opłaty po raz drugi

seed, fps, steps, cfg i provider nie są akceptowane (400): dobiera je OmevAI.

Odpowiedzią jest 202 z zadaniem:

{
  "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": "…"
}

Zanim zadanie się rozpocznie, cena jest rezerwowana na saldzie klucza. Gdy klip zostanie dostarczony, kwota zostaje pobrana; gdy generowanie się nie powiedzie, rezerwacja zostaje zwolniona. Zachowaj id i access_token: token jest potrzebny do odczytu statusu i pobrania pliku. Jeśli odpowiedź zaginęła, wyślij to samo żądanie z tym samym idempotency_key, aby otrzymać to samo id i token.

2. Sprawdź status

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

Bez tokenu lub z tokenem innego zadania odpowiedzią jest 404. Sprawdzaj status co 10–15 sekund.

`status`	Znaczenie
`queued`, `preprocessing`	zadanie zostało przyjęte, a opis jest przekształcany w plan ujęć
`generating`	klip jest tworzony; `phase` pokazuje `provider_queued` (oczekiwanie na miejsce), `generating` lub `saving`
`processing`	rzadka dodatkowa kontrola po naszej stronie; sprawdzaj dalej
`succeeded`	gotowe: `video.url` to link do pobrania
`failed`	nie udało się: `error.code` i `error.message` podają przyczynę; rezerwacja zostaje zwolniona

3. Pobierz klip

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"

Odpowiedzią jest plik MP4 ze ścieżką dźwiękową. Pobierz go od razu po pomyślnym zakończeniu zadania i przechowuj we własnej pamięci masowej.

Pełny cykl w Pythonie

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"])

Bezpłatne zapytania pomocnicze

GET /v1/videos/models: modele z ich czasami trwania, rozdzielczościami, formatami kadru i cenami za sekundę.
GET /v1/videos/price?model=omev-video&duration=8&resolution=1080p: cena jednego klipu, na przykład {"price_usd": 1.08, "per_second_usd": 0.135, …}. Dla omev-video-premium z obrazami referencyjnymi dodaj &references=1.

Czas i limity

4-sekundowy klip powstaje zwykle w około 2 minuty z omev-video-lite i omev-video-premium oraz w 10–20 sekund z omev-video. Dłuższe klipy trwają dłużej.
Konto może mieć jednocześnie do 2 niedokończonych zadań wideo; trzecie zwraca 429.
Ponowne generowanie i ocena klipu są dostępne w panelu internetowym. Przez API utwórz nowe zadanie, aby spróbować ponownie.
Żądania naruszające zasady dotyczące treści są odrzucane przed jakimkolwiek obciążeniem.

Błędy

Kod	Znaczenie	Co zrobić
`400`	czas trwania spoza zakresu modelu, format kadru lub rozdzielczość, których model nie obsługuje, pierwsza klatka razem z obrazami referencyjnymi, obrazy referencyjne dla modelu innego niż `omev-video-premium` lub parametr, który nie jest akceptowany	popraw żądanie na podstawie `error.message`
`401`	brak klucza API lub nieprawidłowy klucz	sprawdź klucz
`402`	saldo klucza jest niższe niż cena klipu	doładuj saldo
`403`	wideo nie jest włączone dla klucza	napisz do wsparcia
`404`	nieznane zadanie albo brakujący lub błędny `X-Omev-Video-Token`	sprawdź id i token
`409`	`idempotency_key` został już użyty z innymi parametrami lub ta kombinacja jest chwilowo niedostępna	użyj nowego numeru zamówienia; przy niedostępności spróbuj później
`429`	działają już 2 zadania wideo	poczekaj, aż jedno z nich się zakończy
`5xx`	błąd tymczasowy	ponów z tym samym `idempotency_key` po 10–30 sekundach

Wspólny format opisano w sekcji Błędy i ponawianie prób.

Modele i ceny​

1. Utwórz zadanie​

2. Sprawdź status​

3. Pobierz klip​

Pełny cykl w Pythonie​

Bezpłatne zapytania pomocnicze​

Czas i limity​

Błędy​