API Seedance 2.5 : appels, paramètres, limites et coût en crédits

Réponse directe : vous pouvez appeler Seedance 2.5 via l’API Yovid avec une seule clé. Envoyez POST https://yovid.ai/v1/videos/generations avec "model": "seedance-2.5" et un prompt, puis interrogez GET /v1/tasks/{task_id} jusqu’à ce que le statut passe à completed, et lisez output.video_url. Les clips durent de 4 à 30 secondes, et une requête peut contenir jusqu’à 30 images, 10 vidéos et 10 fichiers audio en référence. La facturation utilise les mêmes crédits Yovid que le site, et les crédits ne sont débités que si la tâche réussit.

Sommaire

1. Qui donne accès à Seedance 2.5 par API
2. Démarrage rapide en quatre étapes
3. Paramètres de la requête
4. Comment le mode de génération est choisi
5. Limites des références et des médias
6. Ce que coûte une requête
7. Erreurs, relances et limites de débit
8. Un exemple complet en Python
9. Questions fréquentes

Qui donne accès à Seedance 2.5 par API

Seedance 2.5 est le modèle de ByteDance Seed. Pour les développeurs, ByteDance passe par ses propres plateformes cloud : son annonce de lancement du 31 juillet 2026 annonçait un accès à l’API prochainement via BytePlus ModelArk ; selon la presse, Volcano Engine a ouvert l’accès à l’API en Chine le 7 août ; et la page Seedance 2.5 de ByteDance renvoie vers le playground BytePlus.

Yovid est une plateforme indépendante, sans lien avec ByteDance, qui propose Seedance 2.5 via sa propre API :

• Une clé, une facture. La même clé et les mêmes crédits couvrent Seedance 2.5, 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro et 1.0 Pro Fast.
• Des identifiants publics stables. Vous envoyez seedance-2.5 ; Yovid garde en interne les noms de modèles des fournisseurs, pour qu’ils puissent changer sans casser votre code.
• Le même compte que sur le site. Les clips générés via l’API utilisent l’offre et les crédits dont vous disposez déjà.

La référence complète se trouve dans la documentation de l’API Yovid ; ce guide se concentre sur ce qui est propre à Seedance 2.5.

Démarrage rapide en quatre étapes

1. Créez une clé API

Ouvrez Paramètres → Clés API, nommez la clé et créez-la. La clé secrète complète n’est affichée qu’une seule fois : stockez-la dans un gestionnaire de secrets et chargez-la sur votre serveur sous le nom YOVID_API_KEY. Ne la placez jamais dans du code exécuté dans un navigateur ou une application mobile.

2. Créez une tâche

curl https://yovid.ai/v1/videos/generations \
  -H "Authorization: Bearer $YOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A lighthouse keeper climbs a spiral staircase with a lantern, reaches the lamp room as a storm rolls in, and lights the great lamp. Wind howling, boots on iron steps.",
    "duration": 10,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-10-22T08:30:00.000Z"
}

3. Interrogez la tâche

curl https://yovid.ai/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer $YOVID_API_KEY"

Interrogez la tâche toutes les 5 à 10 secondes tant que le statut est pending ou processing, en espaçant progressivement les requêtes. Quand il passe à completed, l’URL de la vidéo se trouve dans output.video_url ; s’il passe à failed, arrêtez d’interroger et lisez error.

4. Vérifiez vos crédits

curl https://yovid.ai/v1/credits \
  -H "Authorization: Bearer $YOVID_API_KEY"

available correspond à ce qu’une nouvelle tâche peut utiliser ; reserved, aux crédits bloqués pour les tâches encore en cours.

Paramètres de la requête

L’API vérifie chaque valeur par rapport au modèle et à votre offre avant de créer la tâche, et renvoie une erreur 403 ou 422 avec le champ en cause dans param si quelque chose n’est pas autorisé. Si vous partez d’une image, la vidéo reprend ses proportions.

Comment le mode de génération est choisi

Vous n’envoyez jamais de mode côté fournisseur. Yovid le choisit d’après les médias joints :

En mode références, désignez les fichiers dans le prompt selon leur ordre dans chaque tableau : @image1, @image2, @video1, @audio1. Une requête avec références ressemble à ceci :

{
  "model": "seedance-2.5",
  "prompt": "@image1 is the main character. @image2 is the ceramic mug she holds; keep its shape and logo. @image3 is the kitchen. She walks into the kitchen, pours coffee into the mug and turns to the window. Use @audio1 as her voice: she says, \"Finally, Saturday.\"",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/mug.jpg",
    "https://example.com/kitchen.jpg"
  ],
  "audio_urls": ["https://example.com/voice-sample.mp3"],
  "duration": 12,
  "quality": "720p"
}

Les références audio sont propres à l’API : le générateur du site accepte images et vidéos, tandis que l’API ajoute jusqu’à 10 fichiers audio pour une voix, une piste ou un rythme.

Limites des références et des médias

D’après la page des modèles et des entrées de la documentation de l’API :

Tous les médias doivent être des URL publiques en HTTPS. Yovid refuse localhost, les adresses de réseau privé, les URL contenant des identifiants et les noms d’hôte qu’il ne parvient pas à résoudre. Utilisez des URL plutôt que du Base64 : le fournisseur limite le corps de chaque requête à 64 Mo.

Ce que coûte une requête

L’API facture dans les mêmes crédits que le site, aux mêmes tarifs. Au tarif de base des packs de crédits, Seedance 2.5 coûte environ 3 crédits par seconde en 480p et environ 6,1 en 720p : un clip de 10 secondes en 720p revient donc à environ 61 crédits, et un clip de 30 secondes à environ 183. Les abonnés paient moins par seconde.

• Les vidéos de référence sont facturées sur la durée du clip de référence plus celle du résultat, à un tarif plus bas : environ 2,1 crédits par seconde en 480p et 4,6 en 720p.
• Désactiver content_filter multiplie le coût par 1,1.
• Réservation, puis débit. Les crédits sont réservés à la création de la tâche et débités uniquement si elle aboutit ; une tâche échouée vous les rend.
• Accès selon l’offre. Seedance 2.5 demande une offre payante ou un pack de crédits unique. Un compte gratuit reçoit 403 plan_upgrade_required.

Une fois terminée, la tâche indique sa consommation dans credits_used. Les offres et les packs sont détaillés sur la page des tarifs, et l’article Seedance 2.5 gratuit ? présente la façon la moins chère de commencer.

Erreurs, relances et limites de débit

Chaque clé autorise jusqu’à 120 requêtes par minute, interrogations comprises. L’endpoint de création ne prend pas encore en charge les clés d’idempotence : ne relancez donc pas automatiquement un POST si vous ignorez si le premier a abouti, car cela peut créer une seconde tâche et réserver les crédits deux fois. Conservez chaque task_id reçu.

Un exemple complet en Python

import os
import time

import requests

API = "https://yovid.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['YOVID_API_KEY']}"}

create = requests.post(
    f"{API}/v1/videos/generations",
    headers=HEADERS,
    json={
        "model": "seedance-2.5",
        "prompt": (
            "0-10s: a courier in a yellow rain jacket runs out of a subway exit into a night street. "
            "10-20s: she weaves between umbrellas as a taxi brakes. "
            "20-30s: she stops at a door and knocks twice. Rain and traffic, no music."
        ),
        "duration": 30,
        "quality": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
create.raise_for_status()
task_id = create.json()["task_id"]

delay = 5
while True:
    task = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
    task.raise_for_status()
    data = task.json()
    if data["status"] == "completed":
        print(data["output"]["video_url"], data["credits_used"])
        break
    if data["status"] == "failed":
        raise RuntimeError(data["error"])
    time.sleep(delay)
    delay = min(delay * 1.5, 30)

Le prompt utilise des segments minutés, le moyen le plus fiable de remplir un clip de 30 secondes. Le guide des prompts Seedance 2.5 contient 13 prompts à envoyer tels quels, et les comparatifs avec Kling 3.0, Veo 3.1 et Seedance 2.0 vous aident à choisir l’identifiant de modèle à appeler.

Questions fréquentes

Existe-t-il une API officielle Seedance 2.5 ?

ByteDance propose Seedance 2.5 aux développeurs via ses plateformes cloud, Volcano Engine et BytePlus. L’API de Yovid est une alternative indépendante : une seule clé et un seul solde de crédits pour Seedance 2.5 et les autres modèles Seedance.

Quel est l’identifiant de modèle de Seedance 2.5 sur Yovid ?

seedance-2.5. Les autres identifiants publics sont seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-1.5-pro et seedance-1.0-pro-fast.

Quelle durée peut atteindre une vidéo générée par l’API Seedance 2.5 ?

De 4 à 30 secondes par tâche, à régler avec duration.

Quelles résolutions l’API Seedance 2.5 prend-elle en charge ?

La documentation de l’API indique 480p et 720p pour seedance-2.5. Votre offre fixe aussi un plafond, et l’API renvoie une erreur 403 avant de créer la tâche si la qualité demandée le dépasse.

Peut-on envoyer de l’audio comme référence ?

Oui, jusqu’à 10 fichiers MP3 ou WAV dans audio_urls, désignés dans le prompt par @audio1, @audio2, etc. Les références audio ne sont disponibles que via l’API.

Une tâche échouée coûte-t-elle des crédits ?

Non. Les crédits sont réservés à la création de la tâche et débités uniquement si elle aboutit.

Combien de requêtes peut-on envoyer ?

Jusqu’à 120 requêtes par minute et par clé, interrogations comprises, plus une limite de tâches simultanées qui dépend de votre offre. Une réponse 429 signifie qu’il faut attendre, puis relancer en espaçant les tentatives.

Prêt à développer ? Créez une clé dans Paramètres → Clés API et suivez le démarrage rapide de l’API.