Eine API für jedes KI-Videomodell

Das Problem, jedes Modell direkt aufzurufen

Jeder Modellhersteller betreibt eine eigene API, mit eigenem Konto, eigenen Schlüsseln, eigenem Anfrageformat, eigenem Ablauf für den Job-Status und eigener Abrechnung. Wer gegen drei davon baut, muss drei Integrationen pflegen, drei Guthaben aufladen und drei Sätze von Fehlercodes behandeln. Manche Modelle werden von mehreren Plattformen zu unterschiedlichen Preisen angeboten, mit unterschiedlichen Limits und einer Kapazität, die kommt und geht.

Die Kosten zeigen sich, wenn Sie ein neues Modell ausprobieren wollen, was 2026 alle paar Monate vorkommt. Jedes neue Modell bedeutet eine weitere Integration, bevor Sie überhaupt sehen können, ob es zu Ihrem Produkt passt.

So funktioniert Revana

1. Ein Schlüssel. Registrieren Sie sich und erstellen Sie im Dashboard einen API-Schlüssel. Er funktioniert für jedes Modell im Katalog.
2. Eine Anfrage. Senden Sie POST /v1/generations mit einer model-ID und einem input-Objekt. Die Feldnamen sind für jedes Modell gleich: prompt, image_url, end_image_url, image_urls, resolution, duration, aspect_ratio und audio.
3. Ein Preis, bevor etwas läuft. Der Preis des Jobs stammt aus dem Katalog und wird von Ihrem vorausbezahlten Guthaben reserviert. Ein Feld oder Wert, den das Modell nicht unterstützt, wird mit 422 abgelehnt, bevor etwas berechnet wird. Sie können auch max_cost_usd als Obergrenze setzen.
4. Routing. Der Router schickt den Job auf die günstigste Route für dieses Modell. Schlägt die Route fehl oder läuft in ein Timeout, wechselt der Job zur nächsten.
5. Ein Ergebnisformat. Fragen Sie GET /v1/generations/{id} ab. Lautet der Status succeeded, stehen die Dateien in output.urls und der berechnete Betrag in cost_usd. Schlägt der Job fehl, wird die Reservierung freigegeben.

Jobs sind asynchron: Bilder dauern meist Sekunden, Video von unter einer Minute bis zu mehreren Minuten. Die Dokumentation enthält die vollständige Feldreferenz und die Fehlercodes.

Dieselbe Anfrage an drei Modelle

Da das Anfrageformat gemeinsam ist, ist ein Modellvergleich eine Schleife. Dieses Skript sendet einen Prompt an Seedance 2.0, Veo 3.1 Fast und Wan 3.0 und gibt dann jedes Ergebnis mit seinen Kosten aus. Jedes Modell behält seine eigenen Optionen, wählen Sie also Werte, die alle drei akzeptieren; hier sind das 720p, 8 Sekunden und 16:9.

import os
import time

import requests

API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}

PROMPT = (
    "A paper boat sails down a rain-soaked street gutter at dusk, "
    "neon signs reflected in the water. Rain, distant traffic."
)
MODELS = ["seedance-2.0", "veo-3.1-fast", "wan-3.0"]

# Submit the same job to every model; each call returns 202 with an id.
jobs = {}
for model in MODELS:
    resp = requests.post(f"{API}/generations", headers=HEADERS, json={
        "model": model,
        "input": {
            "prompt": PROMPT,
            "resolution": "720p",
            "duration": 8,
            "aspect_ratio": "16:9",
            "audio": True,
        },
        "max_cost_usd": 1.5,
    })
    resp.raise_for_status()
    jobs[model] = resp.json()["id"]

# Poll each job until it finishes.
for model, job_id in jobs.items():
    while True:
        job = requests.get(f"{API}/generations/{job_id}", headers=HEADERS).json()
        if job["status"] in ("succeeded", "failed"):
            break
        time.sleep(5)
    if job["status"] == "succeeded":
        print(model, job["output"]["urls"][0], job["cost_usd"])
    else:
        print(model, "failed:", job["error"])

Zu den Katalogpreisen vom Oktober 2026 kosten die drei Jobs:

Das max_cost_usd von 1.5 deckt alle drei ab. Ein Job, der mehr als seine Obergrenze kosten würde, läuft nicht.

Fallback zwischen Routen

Eine Route ist eine Quelle vorgelagerter Kapazität für ein Modell. Viele Modelle bei Revana haben mehr als eine, und der Router nutzt sie der Reihe nach:

• Die günstigste zuerst. Jeder Job geht auf die günstigste Route, die seine Optionen akzeptiert.
• Bei Fehler die nächste. Schlägt diese Route fehl oder läuft in ein Timeout, wechselt der Job automatisch zur nächsten Route. Das Feld attempts zeigt, wie viele versucht wurden.
• Dasselbe Modell, derselbe Preis. Jede Route bedient das angefragte Modell zum gelisteten Preis. Der Router tauscht nie ein anderes Modell ein.
• Eine Abrechnung. Berechnet wird nur die Route, die erfolgreich ist. Schlagen alle Routen fehl, endet der Job als failed und kostet nichts.

Preise und Credits

Revana funktioniert nach Verbrauch. Es gibt kein Abo, keine Seats und kein monatliches Minimum: Sie kaufen vorausbezahltes Guthaben in Paketen zu $10, $50, $100, $500, $1,000 oder $5,000 und geben es für jedes Modell zu dessen gelistetem Preis aus.

• Die meisten Videomodelle werden pro Sekunde Ausgabe bepreist, nach Auflösung und bei manchen Modellen danach, ob Ton an ist.
• Bildmodelle werden pro Bild bepreist, nach Größe.
• Der Preis wird beim Absenden reserviert, bei Erfolg des Jobs berechnet und bei einem Fehlschlag freigegeben.

Die Preisseite listet die Preise jedes Modells. Unsere Leitfäden zeigen, was gängige Jobs bei Seedance 2.0, Veo 3.1 und Kling 3.0 kosten.

Den Katalog im Code lesen

Der vollständige Katalog ist eine öffentliche JSON-Datei unter https://revana.si/data/models.json. Die wichtigsten Felder für jedes Modell:

Um zum Beispiel jedes Modell aufzulisten, das aus Text ein Video erzeugen kann:

# Every model that can make a video from a text prompt
curl -s https://revana.si/data/models.json \
  | jq -r '.models[] | select(any(.tasks[]; . == "text_to_video")) | .id'

Verwenden Sie es, um eine Modellauswahl zu bauen, Optionen vor dem Absenden zu prüfen oder den Preis eines Jobs in Ihrer eigenen Oberfläche abzuschätzen. Dieselben Daten speisen die Modellseite.

Was Sie vor dem Wechsel wissen sollten

• Optionen unterscheiden sich je nach Modell. Die Feldnamen sind gleich, aber jedes Modell akzeptiert eigene Werte. Kling 3.0 listet zum Beispiel keine Option für das Seitenverhältnis. Prüfen Sie die Modellseite, bevor Sie den model-String ändern.
• Ausgabelinks laufen ab. Laden Sie fertige Dateien herunter und bewahren Sie sie in Ihrem eigenen Speicher auf.
• Das Modell wählen Sie. Das Routing ändert, wo ein Job läuft, nie, welches Modell ihn ausführt. Der Wechsel auf ein anderes Modell ist eine Entscheidung Ihres Codes.
• Preise können sich ändern. Der Katalog zeigt immer die aktuellen Preise, und der Preis jedes Jobs steht fest, sobald Sie ihn absenden.

Bereit zum Ausprobieren? Holen Sie sich einen API-Schlüssel, stöbern Sie bei den Modellen oder beginnen Sie mit dem Schnellstart.