Une seule API pour tous les modèles vidéo IA

Le problème de l'appel direct à chaque modèle

Chaque éditeur de modèle gère sa propre API, avec son propre compte, ses propres clés, son propre format de requête, son propre flux d'état des tâches et sa propre facturation. Construire sur trois d'entre eux, c'est trois intégrations à maintenir, trois soldes à recharger et trois jeux de codes d'erreur à gérer. Certains modèles sont proposés par plusieurs plateformes à des prix différents, avec des limites différentes et une capacité qui va et vient.

Le coût apparaît quand vous voulez essayer un nouveau modèle, ce qui, en 2026, arrive tous les quelques mois. Chaque nouveau modèle exige une intégration de plus avant même que vous puissiez voir s'il convient à votre produit.

Comment fonctionne Revana

1. Une seule clé. Inscrivez-vous et créez une clé API dans le tableau de bord. Elle fonctionne pour tous les modèles du catalogue.
2. Une seule requête. Envoyez POST /v1/generations avec un identifiant model et un objet input. Les noms de champs sont les mêmes pour tous les modèles : prompt, image_url, end_image_url, image_urls, resolution, duration, aspect_ratio et audio.
3. Un prix avant toute exécution. Le prix de la tâche provient du catalogue et est bloqué sur votre solde prépayé. Un champ ou une valeur que le modèle ne prend pas en charge est rejeté avec un 422 avant toute facturation. Vous pouvez aussi définir max_cost_usd comme plafond.
4. Routage. Le routeur envoie la tâche vers la route la moins chère pour ce modèle. Si la route échoue ou dépasse le délai, la tâche passe à la suivante.
5. Un seul format de résultat. Interrogez GET /v1/generations/{id}. Quand le statut est succeeded, les fichiers sont dans output.urls et le montant facturé dans cost_usd. Si la tâche échoue, le blocage est libéré.

Les tâches sont asynchrones : les images prennent généralement quelques secondes, et la vidéo de moins d'une minute à plusieurs minutes. La documentation contient la référence complète des champs et les codes d'erreur.

La même requête sur trois modèles

Comme le format de requête est partagé, comparer des modèles se résume à une boucle. Ce script envoie un prompt à Seedance 2.0, Veo 3.1 Fast et Wan 3.0, puis affiche chaque résultat et son coût. Chaque modèle garde ses propres options : choisissez donc des valeurs que les trois acceptent ; ici, 720p, 8 secondes et 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"])

Aux prix du catalogue d'octobre 2026, les trois tâches coûtent :

Le max_cost_usd de 1.5 couvre les trois. Une tâche qui coûterait plus que son plafond ne s'exécute pas.

Repli entre routes

Une route est une source de capacité en amont pour un modèle. De nombreux modèles de Revana en ont plus d'une, et le routeur les utilise dans l'ordre :

• La moins chère d'abord. Chaque tâche part vers la route la moins chère qui accepte ses options.
• La suivante en cas d'échec. Si cette route échoue ou dépasse le délai, la tâche passe automatiquement à la route suivante. Le champ attempts indique combien ont été essayées.
• Même modèle, même prix. Chaque route sert le modèle que vous avez demandé, au prix listé. Le routeur ne le remplace jamais par un autre modèle.
• Une seule facturation. Seule la route qui réussit est facturée. Si toutes les routes échouent, la tâche se termine en failed et ne coûte rien.

Tarifs et crédits

Revana fonctionne à l'usage. Il n'y a ni abonnement, ni sièges, ni minimum mensuel : vous achetez du crédit prépayé par packs de $10, $50, $100, $500, $1,000 ou $5,000 et le dépensez sur n'importe quel modèle à son prix listé.

• La plupart des modèles vidéo sont tarifés à la seconde de sortie, selon la résolution et, pour certains modèles, selon que le son est activé ou non.
• Les modèles d'image sont tarifés à l'image, selon la taille.
• Le prix est bloqué à l'envoi, facturé quand la tâche réussit et libéré quand elle échoue.

La page des tarifs liste les prix de chaque modèle. Nos guides montrent ce que coûtent les travaux courants sur Seedance 2.0, Veo 3.1 et Kling 3.0.

Lire le catalogue dans le code

Le catalogue complet est un fichier JSON public à l'adresse https://revana.si/data/models.json. Les principaux champs de chaque modèle :

Par exemple, pour lister tous les modèles capables de produire une vidéo à partir d'un texte :

# 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'

Utilisez-le pour construire un sélecteur de modèle, vérifier les options avant d'envoyer, ou estimer le prix d'une tâche dans votre propre interface. Ces mêmes données alimentent la page des modèles.

Ce qu'il faut savoir avant de changer

• Les options varient selon le modèle. Les noms de champs sont partagés, mais chaque modèle accepte ses propres valeurs. Kling 3.0, par exemple, ne liste aucune option de format d'image. Consultez la page du modèle avant de changer la chaîne model.
• Les liens de sortie expirent. Téléchargez les fichiers terminés et conservez-les dans votre propre stockage.
• Le modèle, c'est vous qui le choisissez. Le routage change l'endroit où une tâche s'exécute, jamais le modèle qui l'exécute. Basculer vers un autre modèle est une décision qui revient à votre code.
• Les prix peuvent changer. Le catalogue affiche toujours les prix actuels, et le prix de chaque tâche est fixé au moment où vous l'envoyez.

Prêt à essayer ? Obtenez une clé API, parcourez les modèles, ou commencez par le démarrage rapide.