Passer au contenu principal
POST
Envoyez la requête avec POST /v1/videos/generations, récupérez data[0].task_id, puis interrogez GET /v1/tasks/{task_id}.
string
requis
Utilisez Authorization: Bearer <token>, où <token> est votre clé API APIMart.

Paramètres de requête

string
requis
Utilisez seedance-2-5-flash. L’alias doubao-seedance-2-5-flash est également accepté. Le nom avec un point seedance-2.5-flash n’est pas pris en charge.
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)
Un contenu signalé renvoie HTTP 400 (nsfw_content_detected) sans créer de tâche ni facturer la génération. Les vidéos et sons de référence ne sont pas examinés. La requête peut continuer si le service de modération échoue.
string
requis
Prompt obligatoire. Référencez les médias avec @图片1 / @视频1 / @音频1 ; les indices commencent à 1 et suivent l’ordre de chaque tableau de médias.
string
défaut:"720p"
Uniquement 480p / 720p, avec 720p par défaut. 1080p, 2k, 4k et les autres valeurs renvoient HTTP 400 dès l’envoi.
string
défaut:"adaptive"
Valeurs : 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (par défaut). Alias : aspect_ratio. Les tâches avec images de début/fin, d’édition et d’extension exigent adaptive.
integer
Secondes entières 4–30 ; par défaut 5 pour une requête ordinaire. -1 active la durée automatique. Le mode explicite edit accepte uniquement -1 ou l’omission, traitée comme -1 ; la durée suit la vidéo source. La durée automatique réserve 30 secondes, puis le coût est régularisé selon les tokens utilisés.
boolean
défaut:"true"
Générer du son, true par défaut. Alias : audio. Ce réglage de sortie est distinct des références audio audio_urls.
boolean
défaut:"false"
Ajouter un filigrane de génération par IA, false par défaut.
integer
Graine aléatoire facultative. Une même graine ne garantit pas un résultat identique.
string
défaut:"mp4"
Conteneur de sortie : mp4 (par défaut) ou mov.
string
défaut:"auto"
auto (par défaut), reference, edit ou extend, uniquement avec des médias de référence. Un type explicite déclenche les contrôles à l’envoi décrits ci-dessous.
string[]
Tableau d’images, toutes traitées comme reference_image. Maximum 10 images au total avec image_with_roles. Utilisez ce dernier pour les images de début et de fin.
object[]
Chaque élément contient url et role. Rôles : reference_image, first_frame (1 maximum), last_frame (1 maximum, avec une image de début). Maximum 10 images avec image_urls ; évitez les rôles contradictoires. Avec video_urls / audio_urls, les images de début/fin deviennent des images de référence multimodales.
string[]
Maximum 5 vidéos, de 2–30 secondes chacune, 30 secondes au total. Une vidéo source à éditer doit durer 4–30 secondes.
string[]
Maximum 5 extraits audio, de 2–30 secondes chacun, 30 secondes au total. Les références audio seules sont autorisées, sans image ni vidéo.
boolean
défaut:"false"
Avec true, une image de la dernière frame est renvoyée après réussite dans data.result.videos[].last_frame_url.
Autoriser le modèle à rechercher sur le Web si nécessaire, false par défaut.
object[]
Liste facultative d’outils, par exemple [{"type":"web_search"}] pour la recherche Web.
draft / draft_task_id ne sont pas pris en charge : retirez-les de la requête, sinon HTTP 400 est renvoyé. Utilisez Seedance 2.5 pour le mode brouillon.

Exigences des médias

Utilisez des URL http(s) accessibles publiquement ou des identifiants asset:// approuvés. La résolution de sortie et les limites de pixels des vidéos d’entrée sont contrôlées séparément.

Types de tâches et contraintes

Les contraintes d’un type explicite sont contrôlées avant création et facturation : un échec renvoie HTTP 400. Avec auto, le type est déduit des médias et du prompt, et peut échouer pendant la génération. Même un type explicite peut produire InvalidParameter.TaskTypeMismatch s’il ne correspond pas au prompt.

Exemples de requêtes

Références multimodales

Images de début et de fin

Édition vidéo

Extension vidéo

Ressources privées

Faites approuver les images ou vidéos contenant des visages réels dans la bibliothèque avant d’utiliser asset://. Le champ model de l’import doit aussi être seedance-2-5-flash. Consultez l’API de bibliothèque et utilisez le nom Flash ci-dessous.
Interrogez la tâche de validation avec l’API unifiée. Après approbation, obtenez l’identifiant asset:// dans la liste des ressources, puis utilisez-le dans image_urls, image_with_roles[].url, video_urls ou audio_urls.

État et résultats

Interrogez l’API d’état des tâches. pending / processing : en cours ; completed : réussite ; failed : échec. Lisez data.result.videos[0].url[0] : url est un tableau.

Facturation

  • À l’envoi, un montant est réservé au tarif par seconde de la résolution. Avec une vidéo de référence, le palier avec entrée additionne durée de sortie et durée totale des vidéos de référence.
  • Sans duration, une requête ordinaire réserve 5 secondes de sortie. duration: -1, ou edit sans durée, réserve 30 secondes de sortie.
  • Après réussite : data.usage.completion_tokens ÷ 1,000,000 × tarif applicable par million de tokens, puis remises du compte. La différence est remboursée ou débitée. La présence d’une référence vidéo détermine le palier token ou token-input. Le montant final est data.cost.
  • Un envoi rejeté n’est pas facturé pour la génération. Une génération échouée rembourse le montant réservé. Voir la page des tarifs.

Erreurs courantes