Comment utiliser l'API Runway Gen-4.5 ? Générez votre première vidéo en 5 minutes

TL;DR

• Runway Gen-4.5 est un modèle vidéo de Runway ; sur HiAPI, il existe deux entrées, text-to-video et image-to-video. Ouvrez la page du modèle pour l'essayer en ligne ; les nouveaux utilisateurs reçoivent 200 crédits à l'inscription.
• Les deux entrées coûtent $0.1715 par seconde : 5 secondes $0.8575, 8 secondes $1.372, 10 secondes $1.715.
• Appel : soumettez via POST /v1/tasks, récupérez le taskId pour vérifier le résultat, la vidéo finale se trouve dans output[0].url.

Ce que Runway Gen-4.5 peut faire

• Trois durées : 5, 8 et 10 secondes : 8 secondes suffisent pour un travelling avant, un orbite ou une montée lente.
• 720p fixe : paysage 1280×720, portrait 720×1280, pas besoin de choisir la résolution.
• Image-to-video propose 5 formats : 16:9, 9:16, 4:3, 3:4, 1:1 ; une même image peut donner des versions pour différentes plateformes.
• Aucune piste audio dans la vidéo finale : l'image est confiée au modèle, le son est ajouté au montage.

She turns her head toward the camera and smiles, hair moves in a light breeze, slow push-in

Générer avec ce prompt → (importez un portrait comme première image, choisissez 5 secondes, 3:4)

runway-gen-4.5/image-to-video, 3:4, 832×1104, 5 secondes, $0.8575. Première image : .

Elle tourne son profil vers la caméra et sourit, ses cheveux bougent légèrement, la caméra avance jusqu'à un gros plan sur le visage. Le prompt ne décrit que l'action et le mouvement de caméra ; l'apparence du personnage et la lumière près de la fenêtre viennent entièrement de la première image.

Comment choisir entre les deux entrées

ID du modèle	Entrée	Durée	Format	Idéal pour
runway-gen-4.5/text-to-video	Prompt	5 / 8 / 10 secondes (9:16 uniquement 5 / 10)	16:9, 9:16	Pas de matériel, partir du texte
runway-gen-4.5/image-to-video	1 première image + prompt	5 / 8 / 10 secondes	16:9, 9:16, 4:3, 3:4, 1:1	Le sujet doit correspondre à l'image d'origine, ou besoin de carré, 4:3, 3:4

Les deux entrées sont au même prix, soit $0.1715 par seconde.

Deux parcours pour démarrer

Essayer dans le navigateur (3 étapes)

1. Ouvrez la page du modèle text-to-video ou image-to-video et connectez-vous.
2. Rédigez le prompt ; pour image-to-video, importez d'abord une première image.
3. Choisissez 5 secondes et le format, puis cliquez sur Exécuter.

Appeler via l'API (3 étapes)

1. Créez une clé sur la page API Key de la console et placez-la dans la variable d'environnement HIAPI_KEY.
2. Soumettez via POST https://api.hiapi.ai/v1/tasks, qui renvoie data.taskId.
3. Vérifiez via GET /v1/tasks/{taskId} que status vaut success, puis téléchargez output[0].url.

curl : la première vidéo

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-gen-4.5/text-to-video",
    "input": {
      "prompt": "A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 secondes, 16:9, $0.8575. La vidéo finale ressemble à ceci :

A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting

Générer avec ce prompt → (choisissez 5 secondes, 16:9)

runway-gen-4.5/text-to-video, 16:9, 1280×720, 5 secondes, $0.8575.

Python : soumettre, interroger, télécharger

# pip install requests；d'abord export HIAPI_KEY=votre_clé
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # Lors d'une nouvelle tentative sur la même tâche, utilisez la même Idempotency-Key pour éviter une double facturation
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# image-to-video : version 1:1 de la même image, 8 secondes ($1.372)
url = generate(
    "runway-gen-4.5/image-to-video",
    prompt="The scene slowly comes alive: clouds drift, light shifts across the mountain lake, gentle forward camera move",
    image_urls=["https://votre_hebergement/lake.jpg"],
    duration=8, aspect_ratio="1:1",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Tableau des paramètres

Champ	Obligatoire	Valeurs	Description
prompt	Oui	1–1000 caractères	Décrivez le sujet, l'action et le plan ; pour image-to-video, décrivez seulement l'action et le plan
duration	Non	5 (par défaut) / 8 / 10	Text-to-video en 9:16 uniquement 5 / 10
aspect_ratio	Non	Text : 16:9 (par défaut) 9:16 ; image : 16:9 (par défaut) 9:16 4:3 3:4 1:1	Pour image-to-video, la première image est recadrée au centre selon le format
image_urls	Obligatoire pour image-to-video	1 seule image, jpeg/png/webp, ≤10MB	Première image ; text-to-video n'accepte pas ce champ

Il n'y a pas de resolution, seed, negative_prompt, ni d'image finale.

Les erreurs que vous rencontrerez

Si les paramètres sont incorrects à la soumission, l'API renvoie directement 400, sans créer de tâche ni facturer :

• duration: value must be one of 5, 10 : text-to-video en 9:16 avec 8 secondes.
• duration: value must be one of 5, 8, 10 : seules ces trois durées sont disponibles.
• image_urls: maxItems: got 2, want 1 : image-to-video n'accepte qu'une première image, pas d'image finale.
• image_urls: missing required field "image_urls" : première image non fournie pour image-to-video.
• prompt: maxLength: got 3,000, want 1,000 : le prompt est limité à 1000 caractères.
• additional properties 'negative_prompt', 'cfg_scale' not allowed : ces deux champs n'existent pas sur Runway Gen-4.5.

À noter avant la mise en production

• Utilisez un callback plutôt que l'interrogation : ajoutez au niveau supérieur de la requête (au même niveau que input) "callback": {"url": "https://votre_domaine/hiapi/callback"}, et dédupliquez par taskId.
• Transférez rapidement : output[0].url expire après environ 7 jours ; stockez le fichier dès réception.
• Écrivez explicitement duration et aspect_ratio : pour le text-to-video en portrait, évitez 8 secondes ; figez ces valeurs dans le code, c'est le plus sûr.
• Retentez avec une clé d'idempotence : ajoutez l'en-tête Idempotency-Key, une même clé ne crée qu'une seule tâche.

Questions fréquentes

Peut-on obtenir du 1080p ou de la 4K ?

Non, la sortie est fixée à 720p. Pour du 1080p, vous pouvez utiliser Kling 2.5 Turbo ; voir la comparaison Runway Gen-4.5 vs Kling 2.5 Turbo.

La vidéo finale a-t-elle du son ?

Non, la sortie ne contient que l'image. La musique, les effets sonores et la voix off sont ajoutés au montage.

Peut-on ajouter une image finale à l'image-to-video ?

Non, image_urls n'accepte qu'une seule image. Pour contrôler la fin avec une image finale, utilisez l'image-to-video de Kling 2.5 Turbo.

Que se passe-t-il si le ratio de la première image diffère du format ?

La première image est recadrée au centre selon le format choisi ; placez le sujet au centre pour un meilleur résultat.

Pour le détail des prix, voir Tarifs de l'API Runway Gen-4.5 ; pour plus de cas d'usage, voir Guide complet des prompts Runway Gen-4.5. Pour voir le résultat, copiez le prompt du phare ci-dessus et générez votre première vidéo sur la page du modèle.