curl.
Variantes
Toutes les variantes sont asynchrones. Soumettez via
POST /api/v1/video/queue, puis interrogez POST /api/v1/video/retrieve jusqu’à ce que le corps de la réponse soit video/mp4. Voir Génération vidéo pour le flux général de file d’attente.
Passez resolution parmi : 480p, 720p, 1080p ou 4k (en minuscules). Seedance 2.0 (non Fast) accepte les quatre ; 2.0 Fast et 2.5 n’acceptent que 480p / 720p. Découvrez les ID de modèles disponibles et leurs capacités avec GET /models?type=video — ne codez pas la disponibilité en dur.
Le modèle « un modèle, quatre workflows »
Les variantes reference-to-video (seedance-2-0-reference-to-video-basic, sa sœur Fast et seedance-2-5-reference-to-video-basic) utilisent le même modèle de routage par prompt. Le modèle déduit la tâche du préfixe du prompt et de la forme de vos entrées. Il n’existe pas de champ task ou workflow — la syntaxe du prompt fait office de routage.
La syntaxe du prompt est canonique et sensible à la casse : chevrons, majuscule à la première lettre, un espace avant le nombre —
<Video 1>, <Image 1>, <Audio 1>.
Modèles de workflow
Workflow Reference
Utilisez les fichiers de référence chargés comme donneurs — sujet, scène, mouvement, style, timbre vocal — pour générer une toute nouvelle vidéo. Modèles de prompt canoniques :Refer to <Subject 1> in <Image 1> to generate a 5-second clip of the same character riding a horse through snow.Refer to the camera scene in <Video 1> to generate a similar establishing shot of a futuristic city at dawn.Refer to <Subject 1> in <Image 1> and use the timbre in <Audio 1> for the narrator describing the scene.(les donneurs audio doivent être associés à au moins une image ou vidéo de référence — l’audio seul est rejeté)
Workflow Edit
Modifiez une seule vidéo d’entrée. Tout ce qui n’est pas explicitement mentionné dans le prompt est préservé. Utilisez-le lorsque vous souhaitez un changement localisé (échange de sujet, changement de météo/couleur, ajout/suppression d’élément) plutôt qu’une vidéo entièrement nouvelle. Modèle de prompt canonique :Strictly edit <Video 1>, changing its weather from sunny to a heavy rainstorm.Add snacks such as fried chicken and pizza to the countertop in <Video 1>.Remove the red car from <Video 1>, keeping the rest of the video content unchanged.Replace the perfume featured in <Video 1> with the face cream from <Image 1>, with all original motions and camera work preserved.
<Image 1> comme donneur visuel pour le remplacement.
Ratio d’aspect et durée alignés sur la source
Pour Seedance reference-to-video edit / extend, vous pouvez demander à la sortie de suivre le clip source au lieu de choisir un ratio ou une longueur fixe :
Exigences :
- File d’attente : toute valeur alignée sur la source nécessite
reference_video_urls. - Devis : toute valeur alignée sur la source nécessite
reference_video_total_duration. Une durée alignée sur la source est facturéeceil(reference_video_total_duration)secondes. - Le ratio et la durée sont indépendants — vous pouvez aligner l’un sans l’autre.
- Pour extend, préférez une
durationfixe (la durée à générer) et éventuellementaspect_ratio: "adaptive". Unedurationalignée sur la source est destinée aux tâches d’édition de type « même longueur que la source ».
Workflow Extend
Prolongez un clip unique en avant ou en arrière dans le temps. Par défaut, Seedance ne renvoie que le nouveau contenu — pas le clip d’entrée concaténé avec l’extension. C’est intentionnel, pour la continuité des transitions ; si vous souhaitez que le clip d’entrée soit préservé aux côtés de l’extension, indiquez-le explicitement :Extend <Video 1>, generate a dramatic chase scene through narrow alleys at dusk.Extend <Video 1> backward, the same character walking toward the camera before the original shot begins.Extend <Video 1>, start with <Video 1>, then the camera pulls back to reveal a vast landscape.
Workflow Stitch (Track Completion)
Reliez des clips d’entrée avec des transitions générées par IA. Respectez les plafonds spécifiques à chaque famille de durée combinée et de nombre de clips dans Limites d’entrée multimodale (Seedance 2.0 : ≤3 clips / ≤15 s combinés ; Seedance 2.5 : plafonds vidéo plus élevés). Modèle de prompt canonique :<Video 1> + a smooth seamless cut + followed by <Video 2><Video 1>. The moment a leaf falls to the ground, it sets off a special effect of golden particles. A gust of wind blows by, leading into <Video 2>.<Video 1> + a wisp of smoke transforms into a flock of birds + followed by <Video 2> + a slow dolly-in + followed by <Video 3>
Formule universelle de prompt
À travers les quatre workflows, la formule de rédaction recommandée est :- Subject + Motion : la fondation logique — définit « Qui » réalise « Quelle action »
- Environment + Aesthetics : arrière-plan spatial, éclairage, style visuel
- Camera : type de plan ou mouvement explicite
- Audio : effets sonores d’ambiance ou direction vocale pour une sortie immersive
Strictly edit <Video 1>, changing its <subject + motion + environment + ...>) produit les sorties de la plus haute qualité.
Limites d’entrée multimodale
Les valeurs ci-dessous sont celles acceptées par l’API Venice. Les requêtes hors de ces plages sont rejetées au niveau du schéma avec un 400 avant même d’atteindre l’inférence. Seedance 2.0 et Seedance 2.5 utilisent des plafonds différents. Vérifiez toujours la colonne correspondant à la famille de modèles que vous appelez.Planchers média partagés
Comparaison entre familles
L’audio de référence n’est pris en charge que sur les variantes R2V. Chaque entrée est transmise au modèle sous forme d’élément de contenu
role: "reference_audio" que le prompt adresse comme <Audio 1>, <Audio 2>, … — le modèle utilise chaque clip pour le timbre vocal, les effets sonores ou la musique de fond selon la manière dont le prompt le formule. L’ancien champ singulier audio_url correspond à la même forme de contenu et équivaut désormais à passer un reference_audio_urls à un seul élément.
Taille de la requête
L’endpoint de file d’attente accepte des corps JSON jusqu’à 35 MB. Les URLs de données inline pour de grandes vidéos peuvent dépasser cette limite — pour le workflow Stitch multi-clips en particulier, préférez les URLs à la base64 inline.Tarification
AppelezPOST /api/v1/video/quote pour obtenir un devis pour une forme de requête donnée avant de la soumettre à /video/queue. L’endpoint de devis est la seule source faisant autorité ; les détails tarifaires peuvent changer et ne doivent pas être mis en cache ou dupliqués côté client.
Lorsque des vidéos de référence font partie de la requête, passez également reference_video_total_duration (la somme des durées de tous les clips de référence en secondes) afin que le devis corresponde à ce que /video/queue facturera :
Exemples complets
Tous les exemples supposent queVENICE_API_KEY est défini dans l’environnement.
Text-to-video
Seedance 2.0 text-to-video (4K)
Seedance 2.5 text-to-video (durée plus longue)
Image-to-video (première frame)
Les modèles Seedance I2V (
seedance-2-0-image-to-video-basic, sa variante Fast et seedance-2-5-image-to-video-basic) n’acceptent pas aspect_ratio — le ratio d’aspect de sortie est dérivé automatiquement des dimensions de l’image d’entrée. Passer ce champ renvoie un 400 avec « This model does not support aspect_ratio ». Utilisez les variantes T2V ou R2V si vous avez besoin d’un contrôle explicite du ratio d’aspect.Workflow Reference — donneur de sujet
Workflow Reference Seedance 2.5 — multi-images
Workflow Reference — donneur de sujet + donneur audio
Workflow Edit
Seedance 2.5 edit — durée et ratio alignés sur la source
duration: "auto" (ou "-1") et aspect_ratio: "adaptive" (ou "auto") font suivre la sortie au clip source. Voir Ratio d’aspect et durée alignés sur la source.
Workflow Edit avec ancrage image
Extend en avant
Stitch (3 clips)
Interrogation pour la fin de la génération
Après chaque soumission à la file d’attente, enregistrez lequeue_id renvoyé et interrogez /video/retrieve jusqu’à ce que le corps de la réponse soit video/mp4 :
{ "status": "queued" | "running" | "failed", ... }) jusqu’à ce que la tâche se termine, moment auquel le corps de la réponse bascule sur des octets video/mp4. Voir Génération vidéo pour le modèle complet d’interrogation.
Dépannage
At least one reference is required for this model
Les soumissions reference-to-video doivent inclure au moins l’un de reference_image_urls, reference_video_urls, image_references ou video_references. La génération purement à partir de texte n’est pas un workflow R2V valide — utilisez plutôt un ID de modèle text-to-video. reference_audio_urls seul ne suffit pas (voir la section Audio ci-dessus).
Trop de vidéos / images de référence
Seedance 2.0 plafonne R2V à 9 images et 3 vidéos. Seedance 2.5 relève ces plafonds à 30 images et 10 vidéos. Si vous dépassez la limite de la famille, réduisez les entrées ou assemblez-les hors ligne au préalable.Erreurs de durée / de durée agrégée
- 2.0 : vidéo/audio de référence par clip
[2, 15]s ; vidéo/audio combinés ≤ 15 s ; sortie 4–15 s. - 2.5 : vidéo/audio de référence par clip
[2, 30]s ; vidéo/audio combinés ≤ 30 s ; sortie 4–30 s. - Durée alignée sur la source (
-1/autosur Seedance 2.5) : le clip source doit être de 4–30 s, etreference_video_urls(file d’attente) oureference_video_total_duration(devis) est requis.
Le prompt route vers le mauvais workflow
Le workflow est déduit de la syntaxe du prompt. Erreurs de routage courantes :- Vouloir Extend mais écrire
Refer to ...→ le modèle traite votre vidéo comme un donneur, non comme un canevas à prolonger - Vouloir Stitch mais écrire
Refer to ...→ le modèle en choisit un comme donneur et ignore les autres - Vouloir Edit mais écrire
Generate a video based on <Video 1>→ ambigu ; le modèle peut basculer par défaut sur Reference
Strictly edit <Video 1>, ..., Extend <Video 1>, ..., <Video 1> + ... + followed by <Video 2>.
Médias contenant des personnes non pris en charge
Les modèles publics de l’API Seedance n’exécutent pas de flux d’attestation de consentement (consents.seedance / needs_consent). Les médias contenant des personnes détectables peuvent échouer avec une erreur de politique de contenu ou de fournisseur. Utilisez l’application Venice ou Studio à la place.
Le devis ne correspond pas au montant mis en file d’attente
Si vous avez inclus une vidéo de référence mais n’avez pas passéreference_video_total_duration à /video/quote, le devis et le montant mis en file d’attente peuvent différer. Passez toujours reference_video_total_duration (somme des durées de tous les clips de référence, en secondes) lorsque des vidéos de référence sont présentes.
Références
- Endpoint de file d’attente vidéo Venice :
POST /api/v1/video/queue - Endpoint de devis Venice :
POST /api/v1/video/quote - Guide compagnon : Reference to Video (couvre Kling O3 + Grok Imagine R2V)
- Guide compagnon : Génération vidéo (aperçu file d’attente / interrogation)