Skip to main content
POST

Authentification

string
requis
Tous les points de terminaison de l’API nécessitent une authentification par Bearer TokenObtenez votre API Key :Rendez-vous sur la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la dans l’en-tête de la requête :

Paramètres de la requête

string
requis
Nom du modèle de génération vidéoModèles pris en charge :
  • seedance-2.0 — version standard, prend en charge texte-vers-vidéo, image-vers-vidéo, vidéo à partir de la première/dernière image, vidéo de référence, audio de référence et vidéo avec piste audio
  • seedance-2.0-fast — version rapide, mêmes fonctionnalités que la version standard avec une vitesse de génération supérieure
  • seedance-2.0-mini — version mini, mêmes fonctionnalités que la version standard
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche vidéo.
  • true : vérifier les prompts et les images d’entrée avec omni-moderation-latest
  • false ou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
Contenu vérifié :
  • Texte : prompt, negative_prompt
  • Images : image_urls, image_with_roles[].url, first_frame_image, last_frame_image
  • Ressources privées image asset:// : résoudre puis vérifier leur URL publique d’origine
  • Images Base64 : les vérifier après conversion en URL publique
video_urls, audio_urls ainsi que les ressources privées vidéo/audio ne sont pas vérifiés, car le modèle de modération ne prend pas en charge la vidéo ni l’audio.ID de modèles pris en charge : seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (ancien nom) et seedance-2.5.L’appel de modération lui-même n’est pas facturé à l’utilisateur qui envoie la requête vidéo.
  • Un contenu détecté renvoie immédiatement HTTP 400 (nsfw_content_detected). Aucune tâche ni task_id n’est créé et aucun quota de génération vidéo n’est débité
  • Si la modération est indisponible, expire ou renvoie une réponse incorrecte, le comportement est fail-open et la génération continue. Cette option ne constitue pas une garantie absolue de sécurité du contenu
  • Les entrées impossibles à résoudre en URL publique d’image sont ignorées ; les modèles non pris en charge ignorent silencieusement nsfw_check: true
Exemple :
Réponse en cas de détection :
string
Description du contenu de la vidéoObligatoire pour le texte-vers-vidéo ; facultatif pour l’image-vers-vidéo ou la vidéo-référence-vers-vidéoIl est recommandé de préciser clairement le sujet, l’action, le mouvement de caméra et le style pour de meilleurs résultats
  • Le prompt est limité à 4000 caractères, mais 500 caractères sont recommandés.
  • Le modèle seedance-2.0-mini n’a pas de limite de caractères. Recommandation : les prompts en chinois ne doivent pas dépasser 500 caractères et les prompts en anglais ne doivent pas dépasser 1000 mots. Un texte trop long tend à disperser les informations, et le modèle peut négliger des détails et se concentrer uniquement sur les points clés, ce qui entraîne l’absence de certains éléments dans la vidéo.
Exemple : "A kitten yawning at the camera"
integer
défaut:"5"
Durée de la vidéo (en secondes)Plage prise en charge : de 4 à 15 secondesPar défaut : 5
string
défaut:"16:9"
Rapport d’aspect de la vidéoLe rapport d’aspect doit être compris entre 0.5 et 2.5Options :
  • 16:9 — paysage
  • 9:16 — portrait
  • 1:1 — carré
  • 4:3 — rapport traditionnel
  • 3:4 — rapport traditionnel vertical
  • 21:9 — ultra-large
  • adaptive — adaptatif (s’adapte automatiquement à l’image/vidéo d’entrée)
Par défaut : 16:9
string
défaut:"720p"
Résolution de la vidéoOptions :
  • 480p — définition standard
  • 720p — haute définition
  • 1080p — Full HD (uniquement pris en charge par seedance-2.0)
  • 4k — Ultra HD (uniquement pris en charge par seedance-2.0)
Par défaut : 720p
integer
Seed aléatoire pour contrôler l’aléa du contenu généré
  • Pour une même requête, des valeurs de seed différentes produiront des résultats différents
  • Pour une même requête, la même valeur de seed produira des résultats similaires, mais la cohérence exacte n’est pas garantie
boolean
défaut:"true"
Générer ou non l’audio (vidéo avec piste audio)Lorsque ce paramètre est true, la vidéo inclut un audio d’accompagnement généré par l’IALorsque ce paramètre est false, la vidéo n’inclut aucun audio (vidéo muette)Par défaut : true
boolean
défaut:"false"
Renvoyer ou non l’image de la dernière imageLorsque ce paramètre est true, le résultat de la tâche renvoie également l’URL de l’image de la dernière image de la vidéo, qui peut être utilisée pour la génération vidéo continuePar défaut : false
array<object>
Liste d’outils pour des capacités étendues telles que la recherche webExemple : [{"type": "web_search"}]
array<string>
Tableau d’URL d’images pour image-vers-vidéoPrend en charge deux formats :
  • URL d’image classique : https://example.com/cat.jpg
  • URL d’asset (asset approuvé) : asset://asset_a
Exemple : ["https://example.com/cat.jpg"] ou ["asset://asset_a"]
Les URL d’asset sont prises en charge par tous les modèles Seedance 2.0 : seedance-2.0, seedance-2.0-fast et seedance-2.0-mini.
  • image_urls et image_with_roles ne peuvent pas être utilisés simultanément
  • Maximum de 9 images de référence
array
Tableau d’images avec rôles, prend en charge la spécification de la première/dernière image
Lorsque le champ url utilise une URL d’asset, tous les modèles Seedance 2.0 sont pris en charge : seedance-2.0, seedance-2.0-fast et seedance-2.0-mini.
Exemple :
Format d’URL d’asset :
  • image_urls et image_with_roles ne peuvent pas être utilisés simultanément
  • Lors de l’utilisation d’images de première/dernière image, video_urls et audio_urls ne sont pas disponibles
array<string>
Tableau d’URL de vidéos de référencePrend en charge deux formats :
  • URL de vidéo classique : https://example.com/reference.mp4
  • URL d’asset (asset approuvé) : asset://asset_a
Exemple : ["https://example.com/reference.mp4"] ou ["asset://asset_a"]
Les URL d’asset sont prises en charge par tous les modèles Seedance 2.0 : seedance-2.0, seedance-2.0-fast et seedance-2.0-mini.
  • Lors de l’utilisation d’images de première/dernière image (image_with_roles), les vidéos de référence ne sont pas disponibles
  • Maximum de 3 vidéos de référence, 1.8 s < durée totale < 15.2 s
  • La résolution de la vidéo de référence doit être comprise entre 480P et 720P
array<string>
Tableau d’URL d’audio de référencePrend en charge deux formats :
  • URL audio classique : https://example.com/speech.wav
  • URL d’asset (asset approuvé) : asset://asset_a
Exemple : ["https://example.com/speech.wav"] ou ["asset://asset_a"]
Les URL d’asset sont prises en charge par tous les modèles Seedance 2.0 : seedance-2.0, seedance-2.0-fast et seedance-2.0-mini.
  • Lors de l’utilisation d’images de première/dernière image (image_with_roles), l’audio de référence n’est pas disponible
  • Maximum de 3 fichiers audio de référence, durée totale inférieure ou égale à 15 s
  • L’audio de référence doit être utilisé avec des images de référence ou des vidéos de référence

Réponse

integer
Code d’état de la réponse, 200 en cas de succès
array
Tableau de données de la réponse

Cas d’usage

Cas 1 : texte-vers-vidéo

Cas 2 : image-vers-vidéo (première image)

Cas 3 : vidéo à partir de la première/dernière image

Cas 4 : vidéo à partir d’une vidéo de référence

Cas 5 : vidéo de référence + audio de référence

Cas 6 : vidéo avec piste audio

Cas 7 : génération vidéo continue (renvoyer la dernière image)

Cas 8 : génération avec la version rapide

Cas 9 : images de référence + vidéo de référence + audio de référence (vidéo multimodale)

Combinez des images de référence, une vidéo de référence et un audio de référence pour générer une vidéo publicitaire immersive en vue à la première personne. Idéal pour la promotion de produits, les publicités de marque et autres scénarios nécessitant la fusion de matériaux provenant de sources multiples.

Cas 10 : image-vers-vidéo avec URL d’asset

Les assets d’avatars virtuels approuvés peuvent être transmis directement comme images de référence sans avoir besoin de les téléverser ni de les soumettre à nouveau à validation.

Cas 11 : spécifier un portrait de référence avec une URL d’asset (image_with_roles)

Cas 12 : version rapide + URL d’asset pour image-vers-vidéo

Cas 13 : image via URL d’asset + vidéo de référence (transfert de mouvement)

Combinez un asset de portrait approuvé avec une vidéo de référence pour faire exécuter au personnage des mouvements spécifiés.
Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez le point de terminaison Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.

Différences avec la version 1.5 Pro