Que fait Génération de vidéos Seedance ?
Générez des vidéos de danse et de mouvement via l'API Seedance (ByteDance) d'AceDataCloud.
Configuration : Consultez authentification pour la configuration du jeton.
Démarrage rapide
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "a dancer performing contemporary ballet in a misty forest"}], "callback_url": "https://api.acedata.cloud/health"}'
Asynchrone : Consultez interrogation des tâches asynchrones. Interrogez via
POST /seedance/tasksavec{"id": "..."}. Ceci renvoie immédiatement un ID de tâche. Interrogez le résultat :
curl -X POST https://api.acedata.cloud/seedance/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id from above>"}'
Modèles
Seedance 2.0 (génération actuelle — référence multimodale)
La série 2.0 ajoute des entrées de référence multimodales : références image de personnes réelles / personnages, audio de référence, et vidéo de référence (voir les workflows ci-dessous).
| Modèle | Idéal pour | Résolution max |
|---|---|---|
doubao-seedance-2-0-260128 | Qualité maximale, référence personne réelle/personnage, sortie 4k | 4k |
doubao-seedance-2-0-fast-260128 | Génération 2.0 plus rapide | 720p |
doubao-seedance-2-0-mini-260615 | Léger / 2.0 le plus économique | 720p |
Seedance 1.x
| Modèle | Type | Idéal pour |
|---|---|---|
doubao-seedance-1-5-pro-251215 | Texte+Image-vers-Vidéo | Drapeau 1.5, support audio |
doubao-seedance-1-0-pro-250528 | Texte+Image-vers-Vidéo | Usage général, qualité fiable |
doubao-seedance-1-0-pro-fast-251015 | Texte+Image-vers-Vidéo | Génération Pro plus rapide |
doubao-seedance-1-0-lite-t2v-250428 | Texte-vers-Vidéo uniquement | Texte-vers-vidéo léger |
doubao-seedance-1-0-lite-i2v-250428 | Image-vers-Vidéo uniquement | Image-vers-vidéo léger |
Workflows
1. Texte-vers-Vidéo
Passez un élément de contenu texte dans le tableau content.
POST /seedance/videos
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "a street dancer doing breakdancing moves in an urban setting"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. Image-vers-Vidéo
Incluez un élément de contenu image (avec un role facultatif) en plus du texte.
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "the person starts dancing gracefully"},
{
"type": "image_url",
"role": "first_frame",
"image_url": {"url": "https://example.com/dancer.jpg"}
}
],
"resolution": "720p",
"duration": 5
}
Rôles des images :
first_frame— l'image est utilisée comme cadre d'ouverturelast_frame— l'image est utilisée comme cadre de fermeturereference_image— l'image est utilisée comme référence de style / sujet / personne réelle (Seedance 2.0 garde la personne ou le personnage référencé cohérent)
Médias de référence (Seedance 2.0 uniquement) :
audio_url— audio de référence pour le timbre vocal / la musique de fond (pas derole)video_url— vidéo de référence pour le sujet, le mouvement de caméra, le mouvement ou le style général (pas derole)
3. Première image + Dernière image
Fournissez à la fois une image de début et de fin :
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "smooth transition between two scenes"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/start.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/end.jpg"}}
]
}
4. Référence de personne réelle / personnage (Seedance 2.0)
Les modèles Seedance 2.0 (doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615) peuvent garder une personne ou un personnage spécifique cohérent à travers une toute nouvelle scène. Passez une ou plusieurs photos comme éléments image_url avec role: "reference_image" — le modèle préserve l'apparence de ce sujet. Jusqu'à 9 images de référence sont acceptées.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "the same person walking through a neon-lit night market, cinematic"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}}
],
"resolution": "1080p",
"duration": 8
}
5. Audio / Vidéo de référence (Seedance 2.0)
Les modèles 2.0 acceptent également l'audio de référence (timbre vocal, musique de fond) et la vidéo de référence (contenu du sujet, mouvement de caméra, mouvement, style général). Ajoutez des éléments de contenu audio_url et/ou video_url. Limites : jusqu'à 3 références audio et 3 références vidéo par requête.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "a singer performing on stage, matching the reference voice and motion"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/person.jpg"}},
{"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}},
{"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}}
],
"generate_audio": true
}
Paramètres
| Paramètre | Valeurs | Description |
|---|---|---|
model | voir le tableau des modèles | Modèle à utiliser (obligatoire) |
content | tableau | Éléments d'entrée : text, image_url, audio_url (2.0), video_url (2.0) (obligatoire) |
resolution | "480p", "720p", "1080p", "4k" | Résolution de sortie. 4k est réservé à doubao-seedance-2-0-260128 (standard) ; 2-0-fast / 2-0-mini max à 720p (défaut : 720p pour pro/2.0, 480p pour lite) |
ratio | "16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive" | Rapport hauteur/largeur (défaut : 16:9) |
duration | 2 – 15 | Durée en secondes (Seedance 2.0 prend en charge 4–15) |
frames | 29–361 (doit satisfaire 25+4n) | Nombre d'images — mutuellement exclusif avec duration |
seed | -1 à 4294967295 | Graine pour résultats reproductibles (-1 = aléatoire) |
generate_audio | true / false | Générer l'audio (pris en charge par doubao-seedance-1-5-pro-251215 et la série doubao-seedance-2-0 ; les autres modèles l'ignorent) |
camerafixed | true / false | Fixer la position de la caméra pendant la génération |
watermark | true / false | Ajouter un filigrane à la vidéo générée |
return_last_frame | true / false | Retourner la dernière image de la vidéo générée |
service_tier | "default", "flex" | Niveau de traitement (défaut : default) |
execution_expires_after | nombre | Seuil de délai d'expiration de la tâche en secondes |
Syntaxe des paramètres en ligne
Vous pouvez également intégrer les paramètres de génération directement dans le prompt texte en utilisant la syntaxe --param value :
A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
Paramètres en ligne pris en charge : --rs (résolution), --rt (ratio), --dur (durée), --frames, --fps (24 uniquement), --seed, --cf (camera_fixed), --wm (filigrane).
Pièges à éviter
- Les noms de modèles utilisent la convention
doubao-*(ex.doubao-seedance-1-0-pro-250528) — les anciens noms courts commeseedance-1.0ne sont pas valides - Le tableau
contentremplace les anciens champsprompt+image_url; utilisez toujourscontent - Les scénarios d'image et de texte sont mutuellement exclusifs par élément de contenu — chaque élément a soit
textsoitimage_url, pas les deux first_frameetlast_framepeuvent être combinés dans une même requête, maisreference_imageest mutuellement exclusif avecfirst_frame/last_frame— ne mélangez pas une image de référence avec les premières/dernières imagesgenerate_audio: trueest pris en charge pardoubao-seedance-1-5-pro-251215et la sériedoubao-seedance-2-0; les autres modèles ignorent ce champ- Les modèles Lite sont divisés :
*-lite-t2v-*n'accepte que du texte,*-lite-i2v-*n'accepte que l'image-vers-vidéo - Les éléments de référence
audio_urletvideo_urlsont utilisés par la série Seedance 2.0 uniquement - Les options de résolution sont
480p,720p,1080pet4k(4kest réservé àdoubao-seedance-2-0-260128;2-0-fast/2-0-minimax à720p) — il n'y a pas de 360p ou 540p - Les valeurs de
service_tiersont"default"et"flex"(pas "standard"/"premium") - La plage de durée est de 2 à 15 secondes (Seedance 2.0 prend en charge 4–15) — les valeurs en dehors de cette plage échoueront
- Les états des tâches utilisent
"succeeded"(pas "completed") — vérifiez cette valeur lors de l'interrogation
MCP :
pip install mcp-seedance| Hébergé :https://seedance.mcp.acedata.cloud/mcp| Voir tous les serveurs MCP