API vidéo Seedance édition officielle

Cette page décrit l’appel des modèles vidéo Seedance édition officielle. Comme les autres modèles vidéo, ils se créent avec POST /v1/videos et s’interrogent avec GET /v1/videos/{id} ; l’authentification, le téléversement des médias, les états d’interrogation, le téléchargement des résultats et la gestion des erreurs sont décrits dans la spécification complète de l’API vidéo. Cette page ne présente que les champs et règles propres à ce groupe de modèles.

Mis à jour le 2026-10-10. Ce groupe de modèles prend en charge uniquement l’interrogation : ne définissez pas callback_url lors de la création, sinon la requête est rejetée. SD édition cloud (SD2.0, SD2.5) et Seedance relais officiel ont des capacités différentes de ce groupe : voir respectivement SD édition cloud et Seedance relais officiel.

Modèles

Le nom du modèle doit correspondre exactement à l’id renvoyé par GET /v1/models, y compris le suffixe 官方版. Chaque série n’a qu’un seul nom de modèle : resolution sélectionne le niveau de sortie, qui détermine aussi la facturation ; le nom du modèle restera le même lorsque de nouveaux niveaux seront ajoutés.

Règles communes

• Résolution : indiquez dans resolution l’un des niveaux du tableau ci-dessus, sans tenir compte de la casse (720p équivaut à 720P) ; à défaut, le niveau le plus bas s’applique. Un niveau non pris en charge par la série renvoie 400, sans repli automatique vers un niveau inférieur.
• Durée : nombre entier de secondes dans duration (ou seconds sous forme de chaîne) ; à défaut, la durée par défaut du tableau ci-dessus s’applique.
• Format d’image : ratio (ou aspect_ratio) accepte 16:9, 9:16, 1:1, 4:3, 3:4 et 21:9 ; valeur par défaut 16:9. auto n’est pas pris en charge.
• Prompt : prompt est obligatoire.
• Audio : aucune option de génération audio ; n’envoyez pas generate_audio.
• Champs facultatifs : negative_prompt (prompt négatif) et seed (entier).

Médias de référence

• Placez les images de référence dans le tableau images au niveau racine.
• Placez les vidéos de référence dans metadata.referenceVideos et l’audio de référence dans metadata.referenceAudios.
• Utilisez un seul champ par type de média ; si plusieurs alias sont envoyés, un seul jeu est retenu, sans fusion.
• Pour les exigences relatives aux URL et le téléversement de fichiers locaux, voir Exigences relatives aux URL des médias et Téléverser un média local.

{
  "model": "seedance-2.5官方版",
  "resolution": "720p",
  "prompt": "Publicité tech reprenant l’apparence du produit des images, le rythme de caméra de la vidéo et l’ambiance sonore de l’audio de référence",
  "duration": 10,
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
    "referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
  }
}

Images de début et de fin

Placez l’image de début et l’image de fin dans metadata.firstFrame et metadata.lastFrame. lastFrame doit être accompagné de firstFrame ; les images de début et de fin ne peuvent pas être combinées avec des images, vidéos ou audios de référence.

{
  "model": "seedance-2.0官方版",
  "prompt": "Transition fluide d’une place vide à l’aube vers le même cadrage la nuit, lumières allumées",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Téléversement de fichier

Vous pouvez aussi envoyer directement un fichier image local avec multipart/form-data, dans le champ input_reference ; dans ce cas, n’envoyez pas images ni image dans la même requête. Les vidéos et audios de référence ne peuvent pas être envoyés sous forme de fichier : obtenez d’abord une URL comme indiqué dans Téléverser un média local.

Anciens noms de modèles

Les anciens noms de modèles avec niveau, Seedance-2.5-720p官方版, Seedance-2.0-720p官方版, Seedance-2.0-fast-720p官方版, seedance-2.0-mini-480p et seedance-2.0-mini-720p, restent utilisables : la sortie et la facturation sont fixées au niveau indiqué dans le nom, et resolution est ignoré. Ils ne sont plus affichés sur la place des modèles ; pour toute nouvelle intégration, utilisez les noms de série du tableau ci-dessus avec resolution.