Aller au contenu
Inscrivez-vous gratuitement
Seedance

API vidéo Seedance : modèles, champs et exigences des médias

Connectez Seedance avec votre BetterToken API Key et choisissez les champs, médias et modes de génération selon le Model ID et l’opération.

Vous pouvez générer des vidéos à partir de texte, d’une image de début ou de médias de référence. Les quatre modèles de la région Chine prennent en charge trois opérations de génération ; les deux SR prennent en charge le texte vers vidéo et l’image vers vidéo avec une seule image de début. Choisissez le Model ID selon l’opération, la durée et le niveau de sortie souhaités.

Préparez votre BetterToken API Key. La Base URL est https://bettertoken.ai/v1 et l’authentification utilise Authorization: Bearer YOUR_API_KEY. Copiez le Model ID à l’identique, en respectant la casse.

Chaque request.json de cette page suit le même processus : demandez un devis, confirmez la création, suivez la tâche et téléchargez le résultat. Le devis ne lance pas la génération ; la création soumet une tâche payante. Consultez les tarifs actuels dans la model plaza.

Modèles et opérations

Le tableau présente les options par opération. Consultez les valeurs par défaut, les quantités de médias et les contraintes de combinaison dans chaque section. Les tailles utilisent 1 MB = 1048576 octets.

Model IDOpérationDurée (secondes)Niveau de sortieRapport d’aspectAudioRôles des médias
ByteDance-Seedance-2.0-SRimage_to_video5–10, pas 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.0-SRtext_to_video5–10, pas 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offAucun
ByteDance-Seedance-2.5-SRimage_to_video5–10, pas 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.5-SRtext_to_video5–10, pas 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offAucun
doubao-seedance-2-0-260128image_to_video4–15, pas 1; disponible : auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-260128reference_to_video4–15, pas 1; disponible : auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-260128text_to_video4–15, pas 1; disponible : auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offAucun
doubao-seedance-2-0-fast-260128image_to_video4–15, pas 1; disponible : auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-fast-260128reference_to_video4–15, pas 1; disponible : auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-fast-260128text_to_video4–15, pas 1; disponible : auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offAucun
doubao-seedance-2-0-mini-260615image_to_video4–15, pas 1; disponible : auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-mini-260615reference_to_video4–15, pas 1; disponible : auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-mini-260615text_to_video4–15, pas 1; disponible : auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offAucun
doubao-seedance-2-5-260628image_to_video4–30, pas 1; disponible : auto480p, 720p, 1080padaptiveon, offfirst_frame, last_frame
doubao-seedance-2-5-260628reference_to_video4–30, pas 1; disponible : auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-5-260628text_to_video4–30, pas 1; disponible : auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offAucun

Les deux modèles SR acceptent uniquement des durées fixes de 5 ou 10 secondes. Les modèles de la région Chine et les SR ont des Model ID distincts ; n’appliquez pas les champs ni les limites de médias d’un modèle à un autre.

Médias d’exemple

Les exemples de génération à partir d’images et de références utilisent une tasse en céramique bleue sur une table blanche. Vous pouvez essayer l’image fournie ou la remplacer d’abord par des médias HTTPS publics que vous avez le droit d’utiliser et qui respectent les limites de cette page.

Image de référence pour la génération vidéo : tasse en céramique bleue sur une table blanche

Du texte à la vidéo

ByteDance-Seedance-2.0-SR

Utilisez cette opération pour générer une vidéo à partir d’une description textuelle seule.

Définissez model sur le Model ID de cette section et operation sur text_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixedfixed
duration.secondsintegerNon5–10, pas 5 s; uniquement en durée fixe5
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNonmp4mp4
output.resolutionstringNon720p, 1080p, 4k720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalsefalse

Exigences des médias

Cette opération n’accepte aucun média.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "ByteDance-Seedance-2.0-SR",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.

ByteDance-Seedance-2.5-SR

Utilisez cette opération pour générer une vidéo à partir d’une description textuelle seule.

Définissez model sur le Model ID de cette section et operation sur text_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixedfixed
duration.secondsintegerNon5–10, pas 5 s; uniquement en durée fixe5
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNonmp4mp4
output.resolutionstringNon720p, 1080p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalsefalse

Exigences des médias

Cette opération n’accepte aucun média.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "ByteDance-Seedance-2.5-SR",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.

doubao-seedance-2-0-260128

Utilisez cette opération pour générer une vidéo à partir d’une description textuelle seule.

Définissez model sur le Model ID de cette section et operation sur text_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p, 1080p, 4k720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Cette opération n’accepte aucun média.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-260128",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.

doubao-seedance-2-0-fast-260128

Utilisez cette opération pour générer une vidéo à partir d’une description textuelle seule.

Définissez model sur le Model ID de cette section et operation sur text_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Cette opération n’accepte aucun média.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-fast-260128",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.

doubao-seedance-2-0-mini-260615

Utilisez cette opération pour générer une vidéo à partir d’une description textuelle seule.

Définissez model sur le Model ID de cette section et operation sur text_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Cette opération n’accepte aucun média.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-mini-260615",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.

doubao-seedance-2-5-260628

Utilisez cette opération pour générer une vidéo à partir d’une description textuelle seule.

Définissez model sur le Model ID de cette section et operation sur text_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autoauto
duration.secondsintegerNon4–30, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p, 1080p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Cette opération n’accepte aucun média.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-5-260628",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.

De l’image à la vidéo

ByteDance-Seedance-2.0-SR

Utilisez cette opération pour définir l’image de début ou les images de début et de fin à partir d’images.

Définissez model sur le Model ID de cette section et operation sur image_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixedfixed
duration.secondsintegerNon5–10, pas 5 s; uniquement en durée fixe5
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNonmp4mp4
output.resolutionstringNon720p, 1080p, 4k720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalsefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
first_frameimage, 1 (obligatoire)jpeg, png, webpTaille maximale : 10 MB; largeur : 128–4096 px; hauteur : 128–4096 px

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Vous devez fournir first_frame.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "ByteDance-Seedance-2.0-SR",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

ByteDance-Seedance-2.5-SR

Utilisez cette opération pour définir l’image de début ou les images de début et de fin à partir d’images.

Définissez model sur le Model ID de cette section et operation sur image_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixedfixed
duration.secondsintegerNon5–10, pas 5 s; uniquement en durée fixe5
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringNonmp4mp4
output.resolutionstringNon720p, 1080p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalsefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
first_frameimage, 1 (obligatoire)jpeg, png, webpTaille maximale : 10 MB; largeur : 128–4096 px; hauteur : 128–4096 px

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Vous devez fournir first_frame.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "ByteDance-Seedance-2.5-SR",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

doubao-seedance-2-0-260128

Utilisez cette opération pour définir l’image de début ou les images de début et de fin à partir d’images.

Définissez model sur le Model ID de cette section et operation sur image_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p, 1080p, 4k720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
first_frameimage, 1 (obligatoire)jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
last_frameimage, facultatif, au maximum 1jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Vous devez fournir first_frame.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-260128",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

doubao-seedance-2-0-fast-260128

Utilisez cette opération pour définir l’image de début ou les images de début et de fin à partir d’images.

Définissez model sur le Model ID de cette section et operation sur image_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
first_frameimage, 1 (obligatoire)jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
last_frameimage, facultatif, au maximum 1jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Vous devez fournir first_frame.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-fast-260128",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

doubao-seedance-2-0-mini-260615

Utilisez cette opération pour définir l’image de début ou les images de début et de fin à partir d’images.

Définissez model sur le Model ID de cette section et operation sur image_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
first_frameimage, 1 (obligatoire)jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
last_frameimage, facultatif, au maximum 1jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Vous devez fournir first_frame.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-mini-260615",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

doubao-seedance-2-5-260628

Utilisez cette opération pour définir l’image de début ou les images de début et de fin à partir d’images.

Définissez model sur le Model ID de cette section et operation sur image_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autoauto
duration.secondsintegerNon4–30, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNonadaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p, 1080p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
first_frameimage, 1 (obligatoire)jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
last_frameimage, facultatif, au maximum 1jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Vous devez fournir first_frame.
  • Cette opération exige output.aspect_ratio="adaptive", avec l’image de début seule comme avec les images de début et de fin.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-5-260628",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

Génération avec références

doubao-seedance-2-0-260128

Utilisez cette opération pour conserver les caractéristiques du sujet ou du mouvement à l’aide de médias de référence.

Définissez model sur le Model ID de cette section et operation sur reference_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p, 1080p, 4k720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
reference_imageimage, facultatif, au maximum 9jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
reference_videovideo, facultatif, au maximum 3mp4, movTaille maximale : 200 MB; largeur : 300–6000 px; hauteur : 300–6000 px; durée : 2–15 s; fréquence d’images minimale : 24 fps ; maximale : 60 fps; durée totale maximale de ce rôle : 15 s
reference_audioaudio, facultatif, au maximum 3wav, mp3Taille maximale : 15 MB; durée : 2–15 s; durée totale maximale de ce rôle : 15 s

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Fournissez au moins un de ces rôles : reference_image, reference_video, reference_audio.
  • L’audio de référence ne peut pas être utilisé seul ; fournissez aussi des images ou des vidéos de référence.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-260128",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

doubao-seedance-2-0-fast-260128

Utilisez cette opération pour conserver les caractéristiques du sujet ou du mouvement à l’aide de médias de référence.

Définissez model sur le Model ID de cette section et operation sur reference_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
reference_imageimage, facultatif, au maximum 9jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
reference_videovideo, facultatif, au maximum 3mp4, movTaille maximale : 200 MB; largeur : 300–6000 px; hauteur : 300–6000 px; durée : 2–15 s; fréquence d’images minimale : 24 fps ; maximale : 60 fps; durée totale maximale de ce rôle : 15 s
reference_audioaudio, facultatif, au maximum 3wav, mp3Taille maximale : 15 MB; durée : 2–15 s; durée totale maximale de ce rôle : 15 s

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Fournissez au moins un de ces rôles : reference_image, reference_video, reference_audio.
  • L’audio de référence ne peut pas être utilisé seul ; fournissez aussi des images ou des vidéos de référence.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-fast-260128",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

doubao-seedance-2-0-mini-260615

Utilisez cette opération pour conserver les caractéristiques du sujet ou du mouvement à l’aide de médias de référence.

Définissez model sur le Model ID de cette section et operation sur reference_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autofixed
duration.secondsintegerNon4–15, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
reference_imageimage, facultatif, au maximum 9jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
reference_videovideo, facultatif, au maximum 3mp4, movTaille maximale : 200 MB; largeur : 300–6000 px; hauteur : 300–6000 px; durée : 2–15 s; fréquence d’images minimale : 24 fps ; maximale : 60 fps; durée totale maximale de ce rôle : 15 s
reference_audioaudio, facultatif, au maximum 3wav, mp3Taille maximale : 15 MB; durée : 2–15 s; durée totale maximale de ce rôle : 15 s

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Fournissez au moins un de ces rôles : reference_image, reference_video, reference_audio.
  • L’audio de référence ne peut pas être utilisé seul ; fournissez aussi des images ou des vidéos de référence.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-0-mini-260615",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

doubao-seedance-2-5-260628

Utilisez cette opération pour conserver les caractéristiques du sujet ou du mouvement à l’aide de médias de référence.

Définissez model sur le Model ID de cette section et operation sur reference_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.

ChampTypeObligatoireValeurs ou plageValeur par défaut
audio.modestringNonon, offon
duration.modestringNonfixed, autoauto
duration.secondsintegerNon4–30, pas 1 s; uniquement en durée fixeAucun
output.aspect_ratiostringNon16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringNonmp4mp4
output.resolutionstringNon480p, 720p, 1080p720p
promptstringOuiChaîneAucun
watermarkbooleanNonfalse, truefalse

Exigences des médias

Rôle du médiaType et quantitéFormatsLimites par fichier
reference_imageimage, facultatif, au maximum 30jpeg, png, webp, bmp, tiff, gif, heic, heifTaille : 1–31457279 octets; largeur : 300–6000 px; hauteur : 300–6000 px
reference_videovideo, facultatif, au maximum 10mp4, movTaille maximale : 200 MB; largeur : 300–6000 px; hauteur : 300–6000 px; durée : 2–30 s; fréquence d’images minimale : 24 fps ; maximale : 60 fps; durée totale maximale de ce rôle : 30 s
reference_audioaudio, facultatif, au maximum 10wav, mp3Taille maximale : 15 MB; durée : 2–30 s; durée totale maximale de ce rôle : 30 s

Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.

Contraintes de combinaison

  • duration.mode="fixed" exige duration.seconds. Si vous indiquez explicitement fixed, précisez aussi le nombre de secondes.
  • Avec duration.mode="auto", n’envoyez pas duration.seconds.
  • Fournissez au moins un de ces rôles : reference_image, reference_video, reference_audio.

Exemple de requête

Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.

{
"model": "doubao-seedance-2-5-260628",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Erreurs 422 courantes

Code d’erreur 422Solution
enum / range / stepAjustez les valeurs et le pas selon le tableau des champs de cette section.
unsupported_fieldSupprimez les champs absents du tableau de cette opération.
requiresAjoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section.
excludesSupprimez les champs incompatibles avec la durée automatique ou l’image de fin.
count / media_roleAjustez les rôles et les quantités selon le tableau des médias de cette section.
video_input_unsupportedVérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis.

Documentation officielle

Pour appeler BetterToken, utilisez les champs de cette page et l’opération correspondante du catalogue de modèles en temps réel.