API für Videoerzeugung

Beschreiben Sie einen Clip in einfachen Worten, wählen Sie ein Modell, eine Dauer und ein Bildformat, und Sie erhalten eine MP4-Datei mit Tonspur. OmevAI plant die Einstellungen und Kamerabewegungen anhand Ihrer Beschreibung; Sie wählen nur, was unten aufgeführt ist. Der Preis steht vor dem Start fest, und Sie bezahlen nur einen Clip, der tatsächlich geliefert wird.

Zugriff wird auf Anfrage freigeschaltet

Die Video-API wird pro Schlüssel freigeschaltet. Schreiben Sie an support@omev.be, um sie zu aktivieren. Dieselben Modelle sind im Web-Cabinet verfügbar, siehe Videoerzeugung im Cabinet.

Video arbeitet asynchron: Sie erstellen einen Auftrag, prüfen seinen Status und laden die fertige Datei herunter. Alle Aufrufe nutzen den üblichen Host https://llmapi.omev.be und Ihren OmevAI-API-Schlüssel.

Modelle und Preise

`model`	Am besten für	Dauer	`resolution`	Was Sie senden können	Preis pro Sekunde
`omev-video-lite`	einfache Szenen, niedriger Preis	4–12 s	`768p`	Text; Text und ein erster Frame	$0.039
`omev-video`	Menschen, komplexe Bewegung, Kamerabewegung, mehrere Handlungen	4–15 s	`720p` (Standard), `1080p`	Text; Text und ein erster Frame	720p $0.069 · 1080p $0.135
`omev-video-premium`	Premium-Qualität, Clips bis 30 s	4–30 s	`720p` (Standard), `1080p`	Text; Text und ein erster Frame; Text und bis zu 5 Referenzbilder	Text oder erster Frame: 720p $0.075 · 1080p $0.15; mit Referenzbildern: 720p $0.11 · 1080p $0.22

Bildformate (aspect_ratio): omev-video-lite akzeptiert 16:9, 21:9, 4:3, 1:1, 3:4, 9:16; omev-video und omev-video-premium akzeptieren 16:9, 4:3, 1:1, 3:4, 9:16.

Der Preis eines Clips ist der Preis pro Sekunde multipliziert mit der bestellten Dauer. Ein 8-Sekunden-Clip mit omev-video in 720p kostet 8 × $0.069 = $0.552, in 1080p $1.08. Ein 8-Sekunden-Clip mit omev-video-premium in 720p kostet $0.60 aus Text oder einem ersten Frame und $0.88 mit Referenzbildern.

1. Einen Auftrag erstellen

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

Feld	Erforderlich	Werte
`model`	ja	`omev-video-lite`, `omev-video` oder `omev-video-premium`
`prompt`	ja	die Beschreibung des Clips, bis zu 4.000 Zeichen
`duration`	ja	ganze Sekunden innerhalb des Bereichs des Modells
`aspect_ratio`	nein	ein Bildformat, das das Modell akzeptiert, Standard `16:9`
`resolution`	nein	`720p` oder `1080p` für `omev-video` und `omev-video-premium`; `omev-video-lite` ist immer `768p`
`image`	nein	ein öffentlicher `https`-Link zum ersten Frame (alle drei Modelle); er muss sich ohne Anmeldung öffnen lassen
`references`	nein	bis zu 5 öffentliche `https`-Links zu Referenzbildern: eine Figur, ein Produkt, ein Logo oder ein Stil; nur `omev-video-premium` und nicht zusammen mit `image`
`idempotency_key`	empfohlen	Ihre eigene Bestellnummer, bis zu 100 Zeichen; eine Wiederholung liefert denselben Auftrag und berechnet nicht erneut

seed, fps, steps, cfg und provider werden nicht akzeptiert (400): Diese wählt OmevAI.

Die Antwort ist 202 mit dem Auftrag:

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

Bevor der Auftrag startet, wird der Preis auf dem Guthaben des Schlüssels reserviert. Wird der Clip geliefert, wird er berechnet; schlägt die Generierung fehl, wird die Reservierung freigegeben. Bewahren Sie id und access_token auf: Das Token wird benötigt, um den Status zu lesen und die Datei herunterzuladen. Ist die Antwort verloren gegangen, senden Sie dieselbe Anfrage mit demselben idempotency_key, um dieselbe id und dasselbe Token zu erhalten.

2. Den Status prüfen

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

Ohne Token oder mit dem Token eines anderen Auftrags lautet die Antwort 404. Fragen Sie alle 10–15 Sekunden ab.

`status`	Bedeutung
`queued`, `preprocessing`	der Auftrag ist angenommen und die Beschreibung wird in einen Einstellungsplan umgesetzt
`generating`	der Clip wird erzeugt; `phase` zeigt `provider_queued` (wartet auf einen freien Platz), `generating` oder `saving`
`processing`	eine seltene zusätzliche Prüfung auf unserer Seite; fragen Sie weiter ab
`succeeded`	fertig: `video.url` ist der Download-Link
`failed`	nicht erstellt: `error.code` und `error.message` nennen den Grund; die Reservierung wird freigegeben

3. Den Clip herunterladen

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"

Die Antwort ist die MP4-Datei mit Tonspur. Laden Sie sie herunter, sobald der Auftrag erfolgreich ist, und bewahren Sie sie in Ihrem eigenen Speicher auf.

Vollständiger Ablauf in 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"])

Kostenlose Abfragen

GET /v1/videos/models: die Modelle mit ihren Dauern, Auflösungen, Bildformaten und Preisen pro Sekunde.
GET /v1/videos/price?model=omev-video&duration=8&resolution=1080p: der Preis eines Clips, zum Beispiel {"price_usd": 1.08, "per_second_usd": 0.135, …}. Für omev-video-premium mit Referenzbildern fügen Sie &references=1 hinzu.

Dauer und Limits

Ein 4-Sekunden-Clip dauert mit omev-video-lite und omev-video-premium in der Regel etwa 2 Minuten, mit omev-video 10–20 Sekunden. Längere Clips dauern länger.
Ein Konto kann bis zu 2 unfertige Videoaufträge gleichzeitig haben; ein dritter antwortet mit 429.
Neu erzeugen und bewerten können Sie einen Clip im Web-Cabinet. Über die API erstellen Sie für einen neuen Versuch einen neuen Auftrag.
Anfragen, die gegen die Inhaltsrichtlinie verstoßen, werden vor jeder Berechnung abgelehnt.

Fehler

Code	Bedeutung	Was zu tun ist
`400`	eine Dauer außerhalb des Bereichs des Modells, ein Bildformat oder eine Auflösung, die das Modell nicht akzeptiert, ein erster Frame zusammen mit Referenzbildern, Referenzbilder für ein anderes Modell als `omev-video-premium` oder ein nicht akzeptierter Parameter	korrigieren Sie die Anfrage anhand von `error.message`
`401`	fehlender oder ungültiger API-Schlüssel	prüfen Sie den Schlüssel
`402`	das Guthaben des Schlüssels ist niedriger als der Preis des Clips	laden Sie das Guthaben auf
`403`	Video ist für den Schlüssel nicht freigeschaltet	schreiben Sie an den Support
`404`	unbekannter Auftrag oder ein fehlendes oder falsches `X-Omev-Video-Token`	prüfen Sie die ID und das Token
`409`	der `idempotency_key` wurde bereits mit anderen Parametern verwendet, oder die Kombination ist vorübergehend nicht verfügbar	verwenden Sie eine neue Bestellnummer; bei Nichtverfügbarkeit später erneut versuchen
`429`	es laufen bereits 2 Videoaufträge	warten Sie, bis einer davon endet
`5xx`	vorübergehender Fehler	nach 10–30 Sekunden mit demselben `idempotency_key` wiederholen

Das gemeinsame Format finden Sie unter Fehler und Wiederholungsversuche.

Modelle und Preise​

1. Einen Auftrag erstellen​

2. Den Status prüfen​

3. Den Clip herunterladen​

Vollständiger Ablauf in Python​

Kostenlose Abfragen​

Dauer und Limits​

Fehler​