API vidéo SD édition cloud

Cette page décrit l’appel des modèles vidéo SD édition cloud (SD2.0, SD2.5). 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 est un groupe de modèles distinct de Seedance édition officielle et de Seedance relais officiel : paramètres et capacités ne sont pas interchangeables.

Modèles

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, par exemple "model": "SD2.5", "resolution": "720p" ou "model": "SD2.0", "resolution": "4k".

Règles communes

• Résolution : indiquez dans resolution l’un des niveaux du tableau ci-dessus, sans tenir compte de la casse (4k équivaut à 4K) ; à défaut, le niveau le plus bas 480p 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) ; 5 secondes par défaut.
• Format d’image : ratio (ou aspect_ratio) accepte 16:9, 9:16, 1:1, 4:3, 3:4 et 21:9.
  • SD2.5 : le format d’image doit être indiqué explicitement et auto n’est pas pris en charge ; l’omettre ou envoyer auto renvoie 400.
  • SD2.0 : 1:1 par défaut.
• Prompt :
  • SD2.5 : prompt est obligatoire.
  • SD2.0 : il peut être omis en présence de médias de référence ou d’images de début et de fin, mais il est conseillé de décrire le mouvement et la caméra.
• Génération audio : SD2.5 accepte generate_audio (booléen) ; SD2.0 ne propose pas cette option et son envoi renvoie 400.
• 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.
• SD2.0 accepte au maximum 12 médias, tous types confondus.
• Pour SD2.5, chaque vidéo de référence dure de 2 à 30 secondes, et l’ensemble des vidéos de référence ne doit pas dépasser 30 secondes.
• Utilisez un seul champ par type de média ; si plusieurs alias sont envoyés, un seul jeu est retenu, sans fusion.

{
  "model": "SD2.5",
  "resolution": "1080p",
  "prompt": "Garder le visage et la tenue du personnage de l’image, courir dans une rue pluvieuse la nuit avec le mouvement de caméra de la vidéo",
  "duration": 10,
  "ratio": "9:16",
  "generate_audio": true,
  "images": ["https://cdn.example.com/character.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/camera-motion.mp4"]
  }
}

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": "SD2.0",
  "resolution": "720p",
  "prompt": "La caméra glisse de la côte à l’aube vers la même baie au crépuscule",
  "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 suffixe de niveau (par exemple SD2.5 720P ou SD2.0 4K) 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 SD2.5 ou SD2.0 avec resolution.