Comment utiliser l'API Seedance 2.0 ? Réalisez votre première vidéo en 5 minutes

TL;DR

• Seedance 2.0 est le modèle de génération vidéo de ByteDance, disponible sur HiAPI en trois niveaux : Mini, Fast et Standard. Ouvrez la page du modèle pour générer en ligne ; les nouveaux utilisateurs reçoivent 200 crédits à l'inscription.
• Facturation à la seconde : Mini 720p à $0.0586 par seconde, Standard 720p à $0.293 par seconde, 1080p via la route ext à $0.342 par seconde ; l'audio n'entraîne aucun surcoût.
• L'API ne comporte que deux étapes : POST /v1/tasks pour soumettre, puis récupérez taskId pour consulter le résultat. Les exemples curl et Python ci-dessous sont prêts à copier-coller.

Que peut faire Seedance 2.0 ?

• Texte vers vidéo : 4 à 15 secondes, de 480p à 4K, six formats d'image (16:9, 9:16, 1:1, 4:3, 3:4, 21:9) ; la génération à partir d'images peut aussi utiliser adaptive pour suivre l'image d'origine.
• Image vers vidéo : envoyez la première image (first_frame_url), et éventuellement une dernière image (last_frame_url) pour contrôler l'image finale.
• Références multimodales : jusqu'à 9 images de référence, 3 vidéos de référence et 3 audios de référence, pour verrouiller un personnage, un mouvement de caméra ou un rythme.
• Audio natif : generate_audio est activé par défaut ; les sons d'ambiance et effets sonores sont générés en synchronisation avec l'image.

Ce plan produit de 5 secondes en 720p a été généré directement à partir d'un seul prompt :

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

Générer avec ce prompt →

Deux parcours pour démarrer

Essai en ligne (sans coder)

1. Ouvrez la page du modèle Seedance 2.0, inscrivez-vous ou connectez-vous.
2. Collez le prompt, choisissez la durée, la résolution et le format d'image.
3. Cliquez sur Générer, puis téléchargez directement la vidéo produite (les trois échantillons latte de 5 secondes en 720p de la page de tarifs ont pris entre 168 et 230 secondes entre la soumission et l'achèvement).

Appel API

1. Créez une API Key dans la console.
2. Envoyez POST https://api.hiapi.ai/v1/tasks pour soumettre la tâche ; la réponse contient taskId.
3. Consultez le statut avec GET /v1/tasks/{taskId} ; lorsque status vaut success, téléchargez la vidéo depuis 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": "seedance-2.0",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

Réponse :

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Consulter le résultat :

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python : soumettre, interroger, télécharger

# pip install requests ; d'abord export HIAPI_KEY=votre_Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # En cas de nouvelle soumission d'une même tâche, utilisez la même Idempotency-Key pour éviter une double facturation
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{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)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Lors du réglage du prompt, remplacez model par seedance-2.0-mini et utilisez la résolution 480p : 5 secondes ne coûtent que $0.136 ; une fois le résultat validé, passez en Standard ou en route ext pour produire en haute définition.

Image vers vidéo et références multimodales

Image vers vidéo à partir de la première image : ajoutez first_frame_url dans input, et écrivez adaptive pour le format d'image afin de suivre les proportions de l'image :

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

Images, vidéos et audios de référence : utilisez respectivement reference_image_urls (images de référence plus première et dernière images, 9 au total maximum), reference_video_urls (3 maximum, 15 secondes au total maximum) et reference_audio_urls (3 maximum, 15 secondes au total maximum).

Combinaisons d'entrée de Mini : pour Mini, choisissez l'une des trois options parmi première image, image de référence et vidéo de référence ; duration et resolution sont obligatoires ; pour la version Standard, aspect_ratio est obligatoire.

Route ext : ajoutez "route": "ext" au niveau supérieur, sans changer le nom du modèle. ext ne propose que 720p, 1080p et 4K ; c'est moins cher à la seconde, mais les vidéos de référence ne sont pas acceptées.

À vérifier avant la mise en production

• Utilisez un callback plutôt que l'interrogation répétée : ajoutez au niveau supérieur de la requête "callback": {"url": "https://votre-domaine/hiapi/callback"} ; à la fin de la tâche (succès ou échec), HiAPI vous notifie activement ; dédupliquez par taskId.
• Les vidéos sont conservées environ 7 jours par défaut : après avoir récupéré output[0].url, transférez le fichier vers votre propre stockage ; pour une conservation à long terme, vous pouvez utiliser le stockage persistant de HiAPI (facturé en plus selon le volume stocké).
• Écrivez tous les paramètres : indiquez explicitement duration, resolution et aspect_ratio pour que les coûts correspondent à votre tableau de budget.
• Remboursement automatique en cas d'échec : les tâches échouées ne sont pas facturées ; seules les secondes générées avec succès sont comptées.

Questions fréquentes

Comment choisir entre Mini, Fast et Standard ?

Utilisez Mini pour régler vos prompts, Mini ou Fast 720p pour les vidéos courtes destinées aux réseaux sociaux, et Standard ou la route ext pour du 1080p / 4K. Pour les tarifs détaillés, consultez Tarifs de l'API Seedance 2.0.

Peut-on écrire le prompt en chinois ?

Oui. Le chinois et l'anglais sont pris en charge ; pour un résultat plus stable, décrivez clairement dans des phrases séparées la caméra, les actions, l'éclairage et le son.

Peut-on générer en format vertical ?

Oui. Indiquez 9:16 pour aspect_ratio ; pour la génération image vers vidéo, indiquez adaptive pour suivre les proportions de la première image.

Combien de temps faut-il attendre pour une vidéo ?

Les trois échantillons latte de 5 secondes en 720p de la page de tarifs ont pris entre 168 et 230 secondes entre la soumission et l'achèvement. En production, utilisez un callback pour recevoir le résultat plutôt qu'un temps d'attente fixe.

Copiez le prompt de la montre ci-dessus et générez votre première vidéo sur la page du modèle ; pour d'autres prompts prêts à l'emploi, consultez Exemples de prompts Seedance 2.0.