API vidéo Wan : texte, images, références et montage
Connectez Wan 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, et modifier des vidéos existantes. 3.0 et Prime prennent en charge trois opérations de génération ; pour 2.7, choisissez un Model ID distinct pour le texte vers vidéo, l’image vers vidéo, la génération avec références ou le montage.
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 ID | Opération | Durée (secondes) | Niveau de sortie | Rapport d’aspect | Audio | Rôles des médias |
|---|---|---|---|---|---|---|
wan2.7-i2v | image_to_video | 2–15, pas 1 | 720p, 1080p | Ne pas envoyer | provider_default | first_frame, last_frame, driving_audio |
wan2.7-r2v | reference_to_video | 2–15, pas 1 | 720p, 1080p | 16:9, 9:16, 1:1, 4:3, 3:4 | provider_default | reference_image, reference_video |
wan2.7-t2v | text_to_video | 2–15, pas 1 | 720p, 1080p | 16:9, 9:16, 1:1, 4:3, 3:4 | provider_default | driving_audio |
wan2.7-videoedit | video_edit | 2–15, pas 1; disponible : auto | 720p, 1080p | Ne pas envoyer | provider_default | base_video |
wan3.0-video-prime | image_to_video | 2–30, pas 1; disponible : auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | first_frame, last_frame |
wan3.0-video-prime | reference_to_video | 2–30, pas 1; disponible : auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | reference_image, reference_video, reference_audio |
wan3.0-video-prime | text_to_video | 2–30, pas 1; disponible : auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | Aucun |
wan3.0-video | image_to_video | 2–30, pas 1; disponible : auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | first_frame, last_frame |
wan3.0-video | reference_to_video | 2–30, pas 1; disponible : auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | reference_image, reference_video, reference_audio |
wan3.0-video | text_to_video | 2–30, pas 1; disponible : auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | Aucun |
En image vers vidéo (wan2.7-i2v, ainsi que wan3.0-video / wan3.0-video-prime avec adaptive) et en référence vers vidéo avec adaptive, le résultat reprend le format de l’image d’entrée ; le niveau de sortie fixe le nombre total de pixels, pas des dimensions fixes. Avec l’image d’exemple carrée de cette page, 720p a produit 960×960 et 480p 640×640 lors de nos tests. Pour un cadrage paysage ou portrait fixe, indiquez explicitement output.aspect_ratio (wan2.7-i2v n’accepte pas ce champ ; utilisez une image d’entrée au format voulu).
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.

L’exemple de montage utilise une vidéo d’un garçon sur une place urbaine, d’environ 5.04 secondes, en 1280 × 720 à 24 fps. Elle est transmise comme base_video, et non comme image de référence.
Du texte à la vidéo
wan2.7-t2v
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | provider_default | provider_default |
duration.mode | string | Non | fixed | fixed |
duration.seconds | integer | Non | 2–15, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
driving_audio | audio, facultatif, au maximum 1 | wav, mp3 | Taille maximale : 15 MB; durée : 2–30 s |
Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.
Le média facultatif driving_audio est l’audio qui guide la génération et utilise type="audio". Son rôle diffère de reference_audio, utilisé dans la génération avec références.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, 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": "wan2.7-t2v", "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
wan3.0-video-prime
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | on, off | on |
duration.mode | string | Non | fixed, auto | fixed |
duration.seconds | integer | Non | 2–30, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 480p, 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
Cette opération n’accepte aucun média.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Avec
duration.mode="auto", n’envoyez pasduration.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": "wan3.0-video-prime", "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
excludes | Supprimez les champs incompatibles avec la durée automatique ou l’image de fin. |
wan3.0-video
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | on, off | on |
duration.mode | string | Non | fixed, auto | fixed |
duration.seconds | integer | Non | 2–30, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 480p, 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
Cette opération n’accepte aucun média.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Avec
duration.mode="auto", n’envoyez pasduration.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": "wan3.0-video", "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
excludes | Supprimez les champs incompatibles avec la durée automatique ou l’image de fin. |
De l’image à la vidéo
wan2.7-i2v
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | provider_default | provider_default |
duration.mode | string | Non | fixed | fixed |
duration.seconds | integer | Non | 2–15, pas 1 s; uniquement en durée fixe | 5 |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
first_frame | image, 1 (obligatoire) | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
last_frame | image, facultatif, au maximum 1 | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
driving_audio | audio, facultatif, au maximum 1 | wav, mp3 | Taille maximale : 15 MB; durée : 2–30 s |
Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.
Le média facultatif driving_audio est l’audio qui guide la génération et utilise type="audio". Son rôle diffère de reference_audio, utilisé dans la génération avec références.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, 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": "wan2.7-i2v", "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" }, "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
wan3.0-video-prime
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | on, off | on |
duration.mode | string | Non | fixed, auto | fixed |
duration.seconds | integer | Non | 2–30, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 480p, 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
first_frame | image, 1 (obligatoire) | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
last_frame | image, facultatif, au maximum 1 | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Avec
duration.mode="auto", n’envoyez pasduration.seconds. - Fournissez au moins un de ces rôles :
first_frame,last_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": "wan3.0-video-prime", "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
excludes | Supprimez les champs incompatibles avec la durée automatique ou l’image de fin. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
wan3.0-video
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | on, off | on |
duration.mode | string | Non | fixed, auto | fixed |
duration.seconds | integer | Non | 2–30, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 480p, 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
first_frame | image, 1 (obligatoire) | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
last_frame | image, facultatif, au maximum 1 | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Avec
duration.mode="auto", n’envoyez pasduration.seconds. - Fournissez au moins un de ces rôles :
first_frame,last_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": "wan3.0-video", "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
excludes | Supprimez les champs incompatibles avec la durée automatique ou l’image de fin. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vé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
wan2.7-r2v
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | provider_default | provider_default |
duration.mode | string | Non | fixed | fixed |
duration.seconds | integer | Non | 2–15, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
reference_image | image, facultatif, au maximum 10 | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
reference_video | video, facultatif, au maximum 5 | mp4, mov | Taille maximale : 100 MB; largeur : 240–4096 px; hauteur : 240–4096 px; durée : 1–15 s; fréquence d’images minimale : 16 fps; 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"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Fournissez au moins un de ces rôles :
reference_image,reference_video.
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": "wan2.7-r2v", "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": "16:9" }, "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
wan3.0-video-prime
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | on, off | on |
duration.mode | string | Non | fixed, auto | fixed |
duration.seconds | integer | Non | 2–30, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 480p, 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
reference_image | image, facultatif, au maximum 10 | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
reference_video | video, facultatif, au maximum 5 | mp4, mov | Taille maximale : 100 MB; largeur : 240–4096 px; hauteur : 240–4096 px; durée : 1–15 s; fréquence d’images minimale : 16 fps; durée totale maximale de ce rôle : 15 s |
reference_audio | audio, facultatif, au maximum 5 | wav, mp3 | Taille maximale : 15 MB; durée : 1–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"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Avec
duration.mode="auto", n’envoyez pasduration.seconds. - Fournissez au moins un de ces rôles :
reference_image,reference_video,reference_audio. - Avec des vidéos de référence, la somme de leur durée totale et de la durée de sortie ne doit pas dépasser 30 secondes. En durée automatique, la limite de sortie dépend aussi du temps restant.
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": "wan3.0-video-prime", "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
excludes | Supprimez les champs incompatibles avec la durée automatique ou l’image de fin. |
sum_lte | Réduisez la durée totale des vidéos de référence ou la durée de sortie pour que la somme ne dépasse pas 30 secondes. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
wan3.0-video
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.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | on, off | on |
duration.mode | string | Non | fixed, auto | fixed |
duration.seconds | integer | Non | 2–30, pas 1 s; uniquement en durée fixe | 5 |
output.aspect_ratio | string | Non | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 480p, 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
reference_image | image, facultatif, au maximum 10 | jpeg, jpg, png, bmp, webp | Taille maximale : 20 MB; largeur : 240–8000 px; hauteur : 240–8000 px |
reference_video | video, facultatif, au maximum 5 | mp4, mov | Taille maximale : 100 MB; largeur : 240–4096 px; hauteur : 240–4096 px; durée : 1–15 s; fréquence d’images minimale : 16 fps; durée totale maximale de ce rôle : 15 s |
reference_audio | audio, facultatif, au maximum 5 | wav, mp3 | Taille maximale : 15 MB; durée : 1–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"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Avec
duration.mode="auto", n’envoyez pasduration.seconds. - Fournissez au moins un de ces rôles :
reference_image,reference_video,reference_audio. - Avec des vidéos de référence, la somme de leur durée totale et de la durée de sortie ne doit pas dépasser 30 secondes. En durée automatique, la limite de sortie dépend aussi du temps restant.
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": "wan3.0-video", "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 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
excludes | Supprimez les champs incompatibles avec la durée automatique ou l’image de fin. |
sum_lte | Réduisez la durée totale des vidéos de référence ou la durée de sortie pour que la somme ne dépasse pas 30 secondes. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
Montage vidéo
wan2.7-videoedit
Utilisez cette opération pour modifier les images d’une vidéo existante. Préparez d’abord une vidéo source respectant les limites.
Définissez model sur le Model ID de cette section et operation sur video_edit. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | provider_default | provider_default |
duration.mode | string | Non | fixed, auto | auto |
duration.seconds | integer | Non | 2–15, pas 1 s; uniquement en durée fixe | Aucun |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 720p, 1080p | 1080p |
prompt | string | Oui | Chaîne | Aucun |
provider_options.alibaba.prompt_extend | boolean | Non | true / false; contrôle l’enrichissement du prompt | true |
seed | integer | Non | 0–2147483647, pas 1; graine aléatoire ; 0 accepté | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
base_video | video, 1 (obligatoire) | mp4, mov | Taille maximale : 100 MB; largeur : 240–4096 px; hauteur : 240–4096 px; durée : 1–15 s; fréquence d’images minimale : 16 fps; 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"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Vous devez fournir
base_video. - Avec
duration.mode="auto", n’envoyez pasduration.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": "wan2.7-videoedit", "operation": "video_edit", "prompt": "Keep the boy and his motion in the source video. Give the city plaza warmer evening lighting.", "duration": { "mode": "auto" }, "output": { "resolution": "720p" }, "media": [ { "id": "base", "type": "video", "role": "base_video", "source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4" } ]}Erreurs 422 courantes
| Code d’erreur 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
excludes | Supprimez les champs incompatibles avec la durée automatique ou l’image de fin. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vé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.

