Génération de vidéos

Créez des vidéos avec Seedance, Kling, Omni, Wan, Grok, Veo, Vidu, PixVerse et MiniMax à partir d’un prompt, d’une première image (et éventuellement d’une dernière), ou d’images de référence, vidéos et audio. La génération prend quelques minutes : lancez-la, puis revenez vérifier.

Lancer, vérifier, télécharger

import os, time, requests
API = "https://api.zurelay.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
# 1. Start the video
response = requests.post(f"{API}/videos", headers=HEADERS, json={
    "model": "seedance-2.0",
    "prompt": "A paper boat drifting down a rain-soaked street at night, neon reflections, slow dolly shot",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
})
response.raise_for_status()  # a 4xx says what to fix
job = response.json()
# 2. Poll until it's done (usually 2 to 6 minutes)
while job["status"] in ("queued", "in_progress"):
    time.sleep(10)
    job = requests.get(f"{API}/videos/{job['id']}", headers=HEADERS).json()
if job["status"] == "failed":
    raise SystemExit(job["error"]["message"])
# 3. Download the MP4
video = requests.get(f"{API}/videos/{job['id']}/content", headers=HEADERS)
open("boat.mp4", "wb").write(video.content)

Tous les modèles vidéo fonctionnent de la même façon : changez model et la requête reste identique. Les guides présentent les points forts de chacun : Seedance, Kling, Wan, Grok Imagine, Omni Flash, MiniMax H3, Veo, Vidu et PixVerse.

Paramètres

Partir d’images

Première et dernière image

Animez une image fixe : la vidéo commence exactement sur first_frame. Ajoutez last_frame pour qu’elle se termine sur cette image, et contrôlez ainsi le début et la fin du plan. MiniMax starts à partir d’images de référence à la place.

{
  "model": "seedance-2.0",
  "first_frame": "https://example.com/storefront-day.jpg",
  "last_frame": "https://example.com/storefront-night.jpg",
  "prompt": "Time passes from afternoon to night; lights come on inside the shop.",
  "seconds": 6,
  "resolution": "720p"
}

Images de référence

Fournissez jusqu’à 10 images (Seedance up to 9, Kling up to 10, Omni up to 10, Wan up to 10, Grok up to 3, MiniMax up to 9; Veo, Vidu et PixVerse take none) et mentionnez-les dans le prompt dans l’ordre (@Image1, @Image2…) : les personnes, produits et lieux qu’elles contiennent apparaîtront dans la vidéo.

{
  "model": "seedance-2.5",
  "reference_images": [
    "https://example.com/chef.jpg",
    "https://example.com/kitchen.jpg",
    "https://example.com/dish.jpg"
  ],
  "prompt": "The chef from @Image1 plates the dish from @Image3 in the kitchen from @Image2, close-up, warm light.",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "9:16"
}

Vidéos et audio de référence

Fournissez des vidéos pour reprendre l’apparence et les mouvements d’une personne, un mouvement de caméra ou une scène, et de l’audio pour une voix, une mélodie ou des effets sonores. Mentionnez-les dans le prompt dans l’ordre, comme pour les images : @Video1, @Audio1. Vous pouvez les combiner avec des images de référence, mais pas avec une première image.

{
  "model": "seedance-2.5",
  "reference_images": ["https://example.com/singer.jpg"],
  "reference_videos": ["https://example.com/dance-moves.mp4"],
  "reference_audio": ["https://example.com/chorus.mp3"],
  "prompt": "The singer from @Image1 performs the dance from @Video1 on a rooftop at dusk, singing to @Audio1.",
  "seconds": 8,
  "resolution": "720p"
}

Le modèle analyse chaque seconde d’une vidéo de référence : ces secondes sont donc aussi facturées, à une fraction du prix d’une seconde générée. Une vidéo de 5 s avec une référence de 10 s coûte ainsi ses 5 secondes plus 10 secondes de référence. L’audio de référence ne coûte rien de plus. Chaque objet vidéo indique les secondes de référence facturées (reference_seconds).

Modifier et prolonger une vidéo

Définissez reference_mode sur edit pour modifier une vidéo de référence (remplacer une personne ou un objet, ajouter ou supprimer un élément, changer la musique), ou sur extend pour la prolonger avant ou après. Précisez l’action dans le prompt : “Remplacez la voiture de @Video1 par celle de @Image1”, “Continuez @Video1 pendant que la personne qui danse quitte la scène”.

• Une modification conserve le format et la durée de la vidéo : omettez donc aspect_ratio et seconds. La durée facturée est celle de la vidéo de référence la plus longue, qui doit durer de 4 à 30 secondes.
• Une prolongation conserve le format de la vidéo ; seconds définit la durée de la nouvelle vidéo.
• Sans reference_mode, le modèle décide d’après le prompt. Un prompt interprété comme une demande de modification alors que seconds ou aspect_ratio est défini peut échouer (les vidéos en échec ne sont pas facturées).

Règles pour les images

• PNG, JPEG ou WebP, sous forme de lien https public ou d’URL de données, jusqu’à 10 MB.
• De 300 à 6000 pixels par côté, avec un rapport largeur/hauteur ou hauteur/largeur maximal de 5:2. Les URL de données qui ne respectent pas ces limites sont refusées immédiatement, avec un message explicatif. Les liens sont lus au démarrage de la vidéo : si un lien ne fournit pas d’image exploitable, la vidéo échoue avec invalid_image, sans frais.
• Images de début et de fin ou images de référence, pas les deux dans une même requête.
• Les requêtes sont au format JSON : les images sont transmises sous forme de liens ou d’URL de données, pas par envoi multipart.

L’objet vidéo

{
  "id": "video_abc123",
  "object": "video",
  "model": "seedance-2.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1790870400,
  "completed_at": 1790870562,
  "expires_at": 1793462400,
  "seconds": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "size": "1280x720",
  "generate_audio": true,
  "url": "https://...signed link...",
  "url_expires_at": 1790956962,
  "cost": 1.035,
  "error": null
}

Autres endpoints

Facturation des vidéos

Le coût d’une vidéo correspond à son prix par seconde (selon la résolution) multiplié par sa durée; Kling et PixVerse cost de moins par seconde sans son; les secondes des vidéos de référence sont facturées à une fraction de ce tarif. Au lancement, ce montant est réservé sur votre solde ; il est débité une fois la vidéo terminée, ou libéré en cas d’échec. Une vidéo en échec est gratuite.