Paramètres de la requête | Référence multi-images
API keys for the Singapore and China (Beijing) regions are different. Obtain an API key
The following URL is for the Singapore region. For the China (Beijing) region, use this URL instead: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "image_reference",
"prompt": "In the video, a girl gracefully emerges from a misty, ancient forest. Her steps are light, and the camera captures her every nimble moment. When she stops to look at the lush woods around her, a smile of surprise and joy blossoms on her face. This scene, frozen in an interplay of light and shadow, records her wonderful encounter with nature.",
"ref_images_url": [
"http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
"http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
]
},
"parameters": {
"prompt_extend": true,
"obj_or_bg": ["obj","bg"],
"size": "1280*720"
}
}'
Repeinture vidéo
API keys for the Singapore and China (Beijing) regions are different. Obtain an API key
The following URL is for the Singapore region. For the China (Beijing) region, use this URL instead: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_repainting",
"prompt": "The video shows a black steampunk-style car driven by a gentleman, adorned with gears and copper pipes. The background is a steam-powered candy factory with retro elements, creating a vintage and fun scene.",
"video_url": "http://wanx.alicdn.com/material/20250318/video_repainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"control_condition": "depth"
}
}'
Montage local
API keys for the Singapore and China (Beijing) regions are different. Obtain an API key
The following URL is for the Singapore region. For the China (Beijing) region, use this URL instead: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_edit",
"prompt": "The video shows a Parisian-style French cafe where a lion in a suit elegantly sips coffee. It holds a coffee cup in one hand, taking a gentle sip with a relaxed expression. The cafe is tastefully decorated, with soft hues and warm lighting illuminating the lion's area.",
"mask_image_url": "http://wanx.alicdn.com/material/20250318/video_edit_1_mask.png",
"video_url": "http://wanx.alicdn.com/material/20250318/video_edit_2.mp4",
"mask_frame_id": 1
},
"parameters": {
"prompt_extend": false,
"mask_type": "tracking",
"expand_ratio": 0.05
}
}'
Extension vidéo
API keys for the Singapore and China (Beijing) regions are different. Obtain an API key
The following URL is for the Singapore region. For the China (Beijing) region, use this URL instead: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_extension",
"prompt": "A dog wearing sunglasses skateboarding on the street, 3D cartoon.",
"first_clip_url": "http://wanx.alicdn.com/material/20250318/video_extension_1.mp4"
},
"parameters": {
"prompt_extend": false
}
}'
Outpainting vidéo
API keys for the Singapore and China (Beijing) regions are different. Obtain an API key
The following URL is for the Singapore region. For the China (Beijing) region, use this URL instead: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# The following URL is for the Singapore region. When calling, replace {WorkspaceId} with your actual workspace ID. URLs vary by region.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_outpainting",
"prompt": "An elegant woman passionately plays the violin, with a full symphony orchestra behind her.",
"video_url": "http://wanx.alicdn.com/material/20250318/video_outpainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"top_scale": 1.5,
"bottom_scale": 1.5,
"left_scale": 1.5,
"right_scale": 1.5
}
}'
|
Référence multi-imagesmodel string (Required) Nom du modèle. Exemple : wan2.1-vace-plus. input object (Required) Entrée de base, telle que le prompt. Properties promptstring(Required) Décrit les éléments et les caractéristiques visuelles à inclure dans la vidéo générée. Prend en charge le chinois et l'anglais. La longueur maximale est de 800 caractères, chaque caractère chinois ou lettre comptant comme un seul caractère. Le texte dépassant cette limite est automatiquement tronqué. Pour les techniques de prompting, consultez le Guide de prompts Texte-vers-Vidéo/Image-vers-Vidéo. functionstring(Required) Nom de la fonctionnalité. Pour la référence multi-images, la valeur est image_reference. La référence multi-images accepte jusqu'à 3 images de référence. Ces images peuvent contenir des entités et des arrière-plans, tels que des personnes, des animaux, des vêtements et des scènes. Utilisez un prompt pour décrire le contenu vidéo souhaité, et le modèle combinera les multiples images pour générer un contenu vidéo cohérent. ref_images_urlarray[string] (Required) Tableau d'URL d'images de référence.
-
URL publique :
Vous pouvez fournir 1 à 3 images de référence. Si vous en fournissez plus de 3, seules les 3 premières seront utilisées. Exigences relatives aux images :
- Format : JPG, JPEG, PNG, BMP, TIFF ou WEBP.
- Résolution : la largeur et la hauteur doivent se situer dans la plage de [360, 2000] pixels.
- Taille : jusqu'à 10 Mo.
- L'URL ne doit pas contenir de caractères chinois.
Recommandations :
- Lorsque vous utilisez une image de référence pour une entité, nous vous recommandons de n'inclure qu'une seule entité par image. L'arrière-plan doit être de couleur unie (par exemple, blanc) afin de mieux mettre en valeur l'entité.
- Si vous utilisez un arrière-plan issu d'une image de référence, vous ne pouvez fournir qu'une seule image d'arrière-plan, laquelle ne doit contenir aucune entité.
| parameters object (Optional) Paramètres de traitement vidéo, tels que les paramètres de filigrane. Properties obj_or_bg array[string] (Optional) Ce paramètre permet d'identifier la finalité de chaque image de référence et correspond un à un au paramètre ref_images_url. Chaque élément du tableau précise si l'image à la position correspondante est un « sujet » ou un « arrière-plan » :
obj : indique que l'image constitue l'entité de référence.bg : spécifie que l'image sert de référence d'arrière-plan (une seule autorisée au maximum). Notes d'utilisation :
- Nous vous recommandons de transmettre ce paramètre ; sa longueur doit être identique à celle de
ref_images_url, faute de quoi une erreur sera signalée.
- Ce paramètre peut être omis et prendra par défaut la valeur
["obj"] uniquement si ref_images_url est un tableau à un seul élément.
Exemple : ["obj", "obj", "bg"]. size string (Optional) Résolution de la vidéo générée (largeur*hauteur). Le modèle prend en charge la génération de vidéos 720p. Valeurs valides :
1280*720 (par défaut) : le format d'image vidéo est 16:9, où 1280 correspond à la largeur et 720 à la hauteur.720*1280 : le format d'image vidéo est 9:16.960*960 : le format d'image vidéo est 1:1.832*1088 : le format d'image vidéo est 3:4.1088*832 : le format d'image vidéo est 4:3. duration integer (Optional) Durée de la vidéo générée, en secondes. Cette valeur est fixée à 5. prompt_extendbool (Optional) Indique s'il faut activer la réécriture du prompt. Si cette option est activée, un grand modèle de langage (LLM) réécrit le prompt d'entrée. Cela peut améliorer considérablement les résultats pour les prompts courts, mais augmente le temps de traitement.
true (par défaut) : active la réécriture du prompt.false : désactive la réécriture du prompt. seedinteger(Optional) La graine de nombre aléatoire contrôle l'aléatoire du contenu généré par le modèle. La plage de valeurs pour le paramètre seed est [0, 2147483647]. Si vous ne spécifiez pas de graine, celle-ci est générée automatiquement. Pour obtenir des résultats reproductibles, utilisez la même valeur de graine pour plusieurs requêtes. watermark bool(Optional) Indique s'il faut ajouter un filigrane « Généré par IA » dans le coin inférieur droit de l'image.
false (par défaut) : n'ajoute pas de filigrane.true : ajoute un filigrane. |
Repeinture vidéomodel string (Required) Nom du modèle. Exemple : wan2.1-vace-plus. input object (Required) Entrée de base, telle que le prompt. Properties promptstring(Required) Décrit les éléments et les caractéristiques visuelles à inclure dans la vidéo générée. Prend en charge le chinois et l'anglais. La longueur maximale est de 800 caractères, chaque caractère chinois ou lettre comptant comme un seul caractère. Le texte dépassant cette limite est automatiquement tronqué. Pour les techniques de prompting, consultez le Guide de prompts Texte-vers-Vidéo/Image-vers-Vidéo. functionstring(Required) Nom de la fonctionnalité. Pour la repeinture vidéo, la valeur est video_repainting. La fonctionnalité de repeinture vidéo extrait la pose et les actions de l'entité, la composition, les contours de mouvement et la structure linéaire d'une vidéo d'entrée. Elle combine ensuite ces éléments avec un prompt textuel pour générer une nouvelle vidéo présentant les mêmes caractéristiques dynamiques. Cette fonctionnalité permet également de remplacer l'entité de la vidéo originale à l'aide d'une image de référence, par exemple pour modifier l'apparence d'un personnage tout en conservant les actions originales. video_urlstring (Required) URL de la vidéo d'entrée.
-
URL publique :
Exigences relatives à la vidéo :
- Format : MP4.
- Fréquence d'images : 16 FPS ou plus.
- Taille : jusqu'à 50 Mo.
- Durée : jusqu'à 5 secondes. Les vidéos plus longues sont tronquées aux 5 premières secondes.
- L'URL ne doit pas contenir de caractères chinois.
Résolution de la vidéo de sortie :
- Si la résolution de la vidéo d'entrée est de 720p ou inférieure, la résolution de sortie est identique à celle de l'entrée.
- Si la résolution de la vidéo d'entrée est supérieure à 720p, elle est réduite pour s'adapter à une résolution 720p tout en préservant le format d'image original.
Durée de la vidéo de sortie :
- La durée de la vidéo de sortie correspond à celle de la vidéo d'entrée, dans la limite de 5 secondes maximum.
- Exemple : si la vidéo d'entrée dure 3 secondes, la sortie durera également 3 secondes. Si l'entrée dure 6 secondes, la sortie correspondra aux 5 premières secondes de l'entrée.
ref_images_urlarray[string] (Optional) Tableau d'URL d'images de référence.
-
URL publique :
Seule 1 image de référence est prise en charge. Nous vous recommandons d'utiliser une image d'entité afin de remplacer le contenu de l'entité dans la vidéo d'entrée. Exigences relatives aux images :
- Format : JPG, JPEG, PNG, BMP, TIFF ou WEBP.
- Résolution : la largeur et la hauteur doivent se situer dans la plage de [360, 2000] pixels.
- Taille : jusqu'à 10 Mo.
- L'URL ne doit pas contenir de caractères chinois.
Recommandations :
- Lorsque vous utilisez une image de référence pour une entité, nous vous recommandons que l'image ne contienne qu'une seule entité. L'arrière-plan doit être de couleur unie (par exemple, blanc) afin de mieux mettre en valeur l'entité.
| parameters object (Required) Paramètres de traitement vidéo, tels que les paramètres de filigrane. Properties control_condition string (Required) Méthode d'extraction des caractéristiques vidéo.
posebodyface : extrait les expressions faciales et les mouvements corporels de l'entité à partir de la vidéo d'entrée. Convient aux scénarios nécessitant la préservation des détails des expressions faciales de l'entité.posebody : extrait les mouvements corporels de l'entité à partir de la vidéo d'entrée, à l'exclusion des expressions faciales. Convient aux scénarios où seul le contrôle des mouvements corporels de l'entité est nécessaire.depth : extrait la composition et les contours de mouvement de la vidéo d'entrée.scribble : extrait la structure linéaire de la vidéo d'entrée. strength float (Optional) Ajuste la force de contrôle de la méthode d'extraction des caractéristiques vidéo spécifiée par control_condition sur la vidéo générée. La valeur doit se situer dans la plage [0,0, 1,0]. La valeur par défaut est 1,0. Une valeur plus élevée amène la vidéo générée à adhérer plus fidèlement aux actions et à la composition de la vidéo originale. Une valeur plus faible offre une plus grande liberté créative. prompt_extendbool (Optional) Indique s'il faut activer la réécriture du prompt. Si cette option est activée, un grand modèle de langage (LLM) réécrit le prompt d'entrée. Cela peut améliorer considérablement les résultats pour les prompts courts, mais augmente le temps de traitement.
true (par défaut) : active la réécriture du prompt.false : désactive la réécriture du prompt. (Recommandé)
Si la description textuelle ne correspond pas au contenu vidéo, le modèle risque de mal interpréter l'entrée. Nous vous recommandons de désactiver manuellement l'expansion intelligente et de fournir une description de scène claire et spécifique dans le prompt afin d'améliorer la cohérence et la précision.
seedinteger(Optional) La graine de nombre aléatoire contrôle l'aléatoire du contenu généré par le modèle. La plage de valeurs pour le paramètre seed est [0, 2147483647]. Si vous ne spécifiez pas de graine, celle-ci est générée automatiquement. Pour obtenir des résultats reproductibles, utilisez la même valeur de graine pour plusieurs requêtes. watermark bool(Optional) Indique s'il faut ajouter un filigrane « Généré par IA » dans le coin inférieur droit de l'image.
false (par défaut) : n'ajoute pas de filigrane.true : ajoute un filigrane. |
Montage localmodel string (Required) Nom du modèle. Exemple : wan2.1-vace-plus. input object (Required) Entrée de base, telle que le prompt. Properties promptstring(Required) Décrit les éléments et les caractéristiques visuelles à inclure dans la vidéo générée. Prend en charge le chinois et l'anglais. La longueur maximale est de 800 caractères, chaque caractère chinois ou lettre comptant comme un seul caractère. Le texte dépassant cette limite est automatiquement tronqué. Pour les techniques de prompting, consultez le Guide de prompts Texte-vers-Vidéo/Image-vers-Vidéo. functionstring(Required) Nom de la fonctionnalité : pour le montage local, la valeur est video_edit. La fonctionnalité de montage local permet d'ajouter, de modifier ou de supprimer des éléments dans une zone spécifiée d'une vidéo d'entrée. Vous pouvez également remplacer l'entité ou l'arrière-plan dans la zone de montage pour un montage vidéo granulaire. video_urlstring (Required) URL de la vidéo d'entrée.
-
URL publique :
Exigences relatives à la vidéo :
- Format : MP4.
- Fréquence d'images : 16 FPS ou plus.
- Taille : jusqu'à 50 Mo.
- Durée : jusqu'à 5 secondes. Les vidéos plus longues sont tronquées aux 5 premières secondes.
- L'URL ne doit pas contenir de caractères chinois.
Résolution de la vidéo de sortie :
- Si la résolution de la vidéo d'entrée est de 720p ou inférieure, la résolution de sortie est identique à celle de l'entrée.
- Si la résolution de la vidéo d'entrée est supérieure à 720p, elle est réduite pour s'adapter à une résolution 720p tout en préservant le format d'image original.
Durée de la vidéo de sortie :
- La durée de la vidéo de sortie correspond à celle de la vidéo d'entrée, dans la limite de 5 secondes maximum.
- Exemple : si la vidéo d'entrée dure 3 secondes, la sortie durera également 3 secondes. Si l'entrée dure 6 secondes, la sortie correspondra aux 5 premières secondes de l'entrée.
ref_images_urlarray[string] (Optional) Tableau d'URL d'images de référence.
-
URL publique :
Actuellement, seule 1 image de référence est prise en charge. Cette image peut servir d'entité ou d'arrière-plan pour remplacer le contenu correspondant dans la vidéo d'entrée. Exigences relatives aux images :
- Format : JPG, JPEG, PNG, BMP, TIFF ou WEBP.
- Résolution : la largeur et la hauteur doivent se situer dans la plage de [360, 2000] pixels.
- Taille : jusqu'à 10 Mo.
- L'URL ne doit pas contenir de caractères chinois.
Recommandations :
- Lorsque vous utilisez une image de référence pour une entité, nous vous recommandons que l'image ne contienne qu'une seule entité. L'arrière-plan doit être de couleur unie (par exemple, blanc) afin de mieux mettre en valeur l'entité.
- Si vous utilisez un arrière-plan issu d'une image de référence, celui-ci ne doit contenir aucune entité.
mask_image_urlstring (Optional) URL de l'image masque.
-
URL publique :
Ce paramètre définit la zone de montage de la vidéo. Vous pouvez spécifier soit ce paramètre, soit le paramètre mask_video_url. Nous vous recommandons de privilégier ce paramètre. Dans l'image masque, les zones blanches (valeur de pixel [255, 255, 255]) définissent la région à modifier, tandis que les zones noires (valeur de pixel [0, 0, 0]) définissent la région à conserver. Exigences relatives aux images :
- Format : JPG, JPEG, PNG, BMP, TIFF ou WEBP.
- Résolution de l'image : doit être identique à la résolution de la vidéo d'entrée (
video_url).
- Taille : jusqu'à 10 Mo.
- L'URL ne doit pas contenir de caractères chinois.
mask_frame_idinteger (Optional) Ce paramètre prend effet lorsque mask_image_url n'est pas vide. Il spécifie l'ID de l'image de la vidéo où apparaît la cible du masque. La valeur par défaut est 1, ce qui correspond à la première image de la vidéo. La plage de valeurs est [1, max_frame_id], où max_frame_id = fréquence d'images de la vidéo d'entrée * durée de la vidéo d'entrée + 1.
Par exemple, si une vidéo d'entrée (video_url) a une fréquence de 16 FPS (images par seconde) et une durée de 5 secondes, le nombre total d'images est de 16 × 5 + 1 = 81. Par conséquent, max_frame_id = 81.
mask_video_urlstring (Optional) URL de la vidéo masque.
-
URL publique :
Ce paramètre permet de définir la zone de montage de la vidéo. Vous devez spécifier soit ce paramètre, soit le paramètre mask_image_url. Le format vidéo, la fréquence d'images, la résolution et la durée de la vidéo masque doivent être identiques à ceux de la vidéo d'entrée (video_url). Dans la vidéo masque, les zones blanches (valeur de pixel [255, 255, 255]) définissent la région à modifier, tandis que les zones noires (valeur de pixel [0, 0, 0]) définissent la région à conserver. | parameters object (Optional) Paramètres de traitement vidéo, tels que les paramètres de filigrane. Properties control_condition string (Optional) Méthode d'extraction des caractéristiques vidéo. La valeur par défaut est "", ce qui signifie qu'aucune caractéristique n'est extraite.
posebodyface : extrait les expressions faciales et les mouvements corporels de l'entité à partir de la vidéo d'entrée. Convient aux scénarios où le visage de l'entité occupe une grande partie du cadre et où ses traits sont clairement visibles.depth : extrait la composition et les contours de mouvement de la vidéo d'entrée. mask_type string (Optional) Lorsque mask_image_url n'est pas vide, ce paramètre prend effet pour spécifier le comportement de la zone de montage.
tracking (par défaut) : la zone de montage suit dynamiquement la trajectoire de mouvement de l'objet cible. Convient aux scénarios où le sujet est en mouvement.fixed : la zone de montage reste fixe et ne change pas avec le contenu de l'écran. expand_ratio float (Optional) Lorsque mask_type est défini sur tracking, ce paramètre prend effet et spécifie le ratio d'expansion de la zone de masque vers l'extérieur. La valeur doit se situer dans la plage [0,0, 1,0]. La valeur par défaut est 0,05, ce qui est recommandé. Une valeur plus faible rapproche la zone de masque de l'objet cible, tandis qu'une valeur plus élevée élargit davantage la zone de masque. expand_mode string (Optional) Lorsque mask_type est défini sur tracking, ce paramètre prend effet et spécifie la forme de la zone de masque. L'algorithme génère une vidéo masque de forme correspondante à partir de l'image masque d'entrée, en fonction du expand_mode sélectionné. Les valeurs prises en charge sont les suivantes :
hull (par défaut) : mode polygone. Ce mode utilise un polygone pour englober l'objet masqué.bbox : mode boîte englobante. Ce mode utilise un rectangle pour englober l'objet masqué.original : mode original, qui tente de préserver la forme de la cible de masque originale. size string (Optional) Résolution de la vidéo générée (largeur*hauteur). Le modèle prend en charge la génération de vidéos 720p. Valeurs valides :
1280*720 (par défaut) : le format d'image vidéo est 16:9, où 1280 correspond à la largeur et 720 à la hauteur.720*1280 : le format d'image vidéo est 9:16.960*960 : le format d'image vidéo est 1:1.832*1088 : le format d'image vidéo est 3:4.1088*832 : le format d'image vidéo est 4:3. duration integer (Optional) Durée de la vidéo générée, en secondes. Cette valeur est fixée à 5. prompt_extendbool (Optional) Indique s'il faut activer la réécriture du prompt. Si cette option est activée, un grand modèle de langage (LLM) réécrit le prompt d'entrée. Cela peut améliorer considérablement les résultats pour les prompts courts, mais augmente le temps de traitement.
true (par défaut) : active la réécriture du prompt.false : désactive la réécriture du prompt. (Recommandé)
Si la description textuelle ne correspond pas au contenu vidéo, le modèle risque de mal interpréter l'entrée. Nous vous recommandons de désactiver manuellement l'expansion intelligente et de fournir une description de scène claire et spécifique dans le prompt afin d'améliorer la cohérence et la précision.
seedinteger(Optional) La graine de nombre aléatoire contrôle l'aléatoire du contenu généré par le modèle. La plage de valeurs pour le paramètre seed est [0, 2147483647]. Si vous ne spécifiez pas de graine, celle-ci est générée automatiquement. Pour obtenir des résultats reproductibles, utilisez la même valeur de graine pour plusieurs requêtes. watermark bool(Optional) Indique s'il faut ajouter un filigrane « Généré par IA » dans le coin inférieur droit de l'image.
false (par défaut) : n'ajoute pas de filigrane.true : ajoute un filigrane. |
Extension vidéomodel string (Required) Nom du modèle. Exemple : wan2.1-vace-plus. input object (Required) Entrée de base, telle que le prompt. Properties promptstring(Required) Décrit les éléments et les caractéristiques visuelles à inclure dans la vidéo générée. Prend en charge le chinois et l'anglais. La longueur maximale est de 800 caractères, chaque caractère chinois ou lettre comptant comme un seul caractère. Le texte dépassant cette limite est automatiquement tronqué. Pour les techniques de prompting, consultez le Guide de prompts Texte-vers-Vidéo/Image-vers-Vidéo. functionstring(Required) Nom de la fonction. Pour l'extension vidéo, la valeur est video_extension. La fonctionnalité d'extension vidéo génère du contenu continu à partir d'une image ou d'une vidéo. Elle peut également extraire des caractéristiques dynamiques, telles que des actions et une composition, d'une vidéo de référence pour guider la génération d'une vidéo présentant un mouvement similaire.
La durée totale de la vidéo générée est de 5 secondes. Il s'agit de la durée finale de sortie, et non d'une extension de 5 secondes ajoutée au contenu original.
first_frame_urlstring (Optional) URL de l'image de la première trame.
-
URL publique :
Exigences relatives aux images :
- Format : JPG, JPEG, PNG, BMP, TIFF ou WEBP.
- Résolution : la largeur et la hauteur doivent se situer dans la plage de [360, 2000] pixels.
- Taille : jusqu'à 10 Mo.
- L'URL ne doit pas contenir de caractères chinois.
last_frame_urlstring(Optional) URL de l'image de la dernière trame.
-
URL publique :
Exigences relatives aux images :
- Format : JPG, JPEG, PNG, BMP, TIFF ou WEBP.
- Résolution : la largeur et la hauteur doivent se situer dans la plage de [360, 2000] pixels.
- Taille : jusqu'à 10 Mo.
- L'URL ne doit pas contenir de caractères chinois.
first_clip_urlstring (Optional) URL du premier clip vidéo.
-
URL publique :
Exigences relatives à la vidéo :
- Format : MP4.
- Fréquence d'images vidéo : supérieure ou égale à 16 FPS. Lorsque
first_clip_url et last_clip_url sont utilisés conjointement, nous vous recommandons que les deux clips aient la même fréquence d'images.
- Taille : jusqu'à 50 Mo.
- Longueur vidéo : la vidéo ne peut pas dépasser 3 secondes. Dans le cas contraire, les 3 premières secondes de la vidéo seront utilisées. Si vous spécifiez à la fois
first_clip_url et last_clip_url, la durée totale des deux clips vidéo ne peut pas excéder 3 secondes.
- L'URL ne doit pas contenir de caractères chinois.
Résolution de la vidéo de sortie :
- Si la résolution de la vidéo d'entrée est de 720p ou inférieure, la résolution de sortie est identique à celle de l'entrée.
- Si la résolution de la vidéo d'entrée est supérieure à 720p, elle est réduite pour s'adapter à une résolution 720p tout en préservant le format d'image original.
last_clip_urlstring(Optional) URL du dernier clip vidéo.
-
URL publique :
Exigences relatives à la vidéo :
- Format : MP4.
- Fréquence d'images vidéo : 16 FPS ou plus. Lorsque
first_clip_url et last_clip_url sont utilisés conjointement, nous vous recommandons que les deux clips aient la même fréquence d'images.
- Taille : jusqu'à 50 Mo.
- Durée vidéo : la durée ne peut pas excéder 3 secondes. Si une vidéo est plus longue, seules les 3 premières secondes sont utilisées. Si vous spécifiez à la fois
first_clip_url et last_clip_url, leur durée combinée ne peut pas excéder 3 secondes.
- L'URL ne doit pas contenir de caractères chinois.
Résolution de la vidéo de sortie :
- Si la résolution de la vidéo d'entrée est de 720p ou inférieure, la résolution de sortie est identique à celle de l'entrée.
- Si la résolution de la vidéo d'entrée est supérieure à 720p, elle est réduite pour s'adapter à une résolution 720p tout en préservant le format d'image original.
video_urlstring (Optional) URL de la vidéo d'entrée.
-
URL publique :
Cette vidéo sert principalement à extraire des caractéristiques de mouvement qui fonctionnent conjointement avec les paramètres first_frame_url, last_frame_url, first_clip_url et last_clip_url pour guider la génération d'une vidéo étendue présentant un mouvement similaire. Exigences relatives à la vidéo :
- Format : MP4.
- Fréquence d'images : 16 FPS ou plus, cohérente avec les clips précédents et suivants.
- Résolution : cohérente avec les trames et clips précédents et suivants.
- Taille : jusqu'à 50 Mo.
- Durée : jusqu'à 5 secondes. Les vidéos plus longues sont tronquées aux 5 premières secondes.
- L'URL ne doit pas contenir de caractères chinois.
| parameters object (Optional) Paramètres de traitement vidéo, tels que la définition de la résolution de la vidéo de sortie. Properties control_condition string (Optional) Méthode d'extraction des caractéristiques vidéo. Ce paramètre est requis lorsque video_url est spécifié. La valeur par défaut est "", ce qui signifie qu'aucune caractéristique n'est extraite.
posebodyface : extrait les expressions faciales et les mouvements corporels de l'entité dans la vidéo d'entrée.depth : extrait la composition et les contours de mouvement de la vidéo d'entrée. duration integer (Optional) Durée de la vidéo générée, en secondes. Cette valeur est fixée à 5. prompt_extendbool (Optional) Indique s'il faut activer la réécriture du prompt. Si cette option est activée, un grand modèle de langage (LLM) réécrit le prompt d'entrée. Cela peut améliorer considérablement les résultats pour les prompts courts, mais augmente le temps de traitement.
true (par défaut) : active la réécriture du prompt.false : désactive la réécriture du prompt. (Recommandé)
Si la description textuelle ne correspond pas au contenu vidéo, le modèle risque de mal interpréter l'entrée. Nous vous recommandons de désactiver manuellement l'expansion intelligente et de fournir une description de scène claire et spécifique dans le prompt afin d'améliorer la cohérence et la précision.
seedinteger(Optional) La graine de nombre aléatoire contrôle l'aléatoire du contenu généré par le modèle. La plage de valeurs pour le paramètre seed est [0, 2147483647]. Si vous ne spécifiez pas de graine, celle-ci est générée automatiquement. Pour obtenir des résultats reproductibles, utilisez la même valeur de graine pour plusieurs requêtes. watermark bool(Optional) Indique s'il faut ajouter un filigrane « Généré par IA » dans le coin inférieur droit de l'image.
false (par défaut) : n'ajoute pas de filigrane.true : ajoute un filigrane. |
Outpainting vidéomodel string (Required) Nom du modèle. Exemple : wan2.1-vace-plus. input object (Required) Entrée de base, telle que le prompt. Properties promptstring(Required) Décrit les éléments et les caractéristiques visuelles à inclure dans la vidéo générée. Prend en charge le chinois et l'anglais. La longueur maximale est de 800 caractères, chaque caractère chinois ou lettre comptant comme un seul caractère. Le texte dépassant cette limite est automatiquement tronqué. Pour les techniques de prompting, consultez le Guide de prompts Texte-vers-Vidéo/Image-vers-Vidéo. functionstring(Required) Nom de la fonctionnalité. Pour l'outpainting vidéo, la valeur est video_outpainting. La fonctionnalité d'outpainting vidéo étend proportionnellement le cadre vidéo vers le haut, le bas, la gauche et la droite. video_urlstring (Required) URL de la vidéo d'entrée.
-
URL publique :
Exigences relatives à la vidéo :
- Format : MP4.
- Fréquence d'images : 16 FPS ou plus.
- Taille : jusqu'à 50 Mo.
- Durée : jusqu'à 5 secondes. Les vidéos plus longues sont tronquées aux 5 premières secondes.
- L'URL ne doit pas contenir de caractères chinois.
Résolution de la vidéo de sortie :
- Si la résolution de la vidéo d'entrée est de 720p ou inférieure, la résolution de sortie est identique à celle de l'entrée.
- Si la résolution de la vidéo d'entrée est supérieure à 720p, elle est réduite pour s'adapter à une résolution 720p tout en préservant le format d'image original.
Durée de la vidéo de sortie :
- La durée de la vidéo de sortie correspond à celle de la vidéo d'entrée, dans la limite de 5 secondes maximum.
- Exemple : si la vidéo d'entrée dure 3 secondes, la sortie durera également 3 secondes. Si l'entrée dure 6 secondes, la sortie correspondra aux 5 premières secondes de l'entrée.
| parameters object (Optional) Paramètres de traitement vidéo, tels que la définition des ratios d'extension. Properties top_scale float (Optional) Centre le cadre vidéo et l'étend vers le haut selon le ratio spécifié. La valeur doit se situer dans la plage [1,0, 2,0]. La valeur par défaut est 1,0, ce qui indique aucune extension. bottom_scale float (Optional) Centre le cadre vidéo et l'étend vers le bas selon le ratio spécifié. La valeur doit se situer dans la plage [1,0, 2,0]. La valeur par défaut est 1,0, ce qui indique aucune extension. left_scale float (Optional) Centre le cadre vidéo et l'étend vers la gauche selon le ratio spécifié. La valeur doit se situer dans la plage [1,0, 2,0]. La valeur par défaut est 1,0, ce qui indique aucune extension. right_scale float (Optional) Centre le cadre vidéo et l'étend vers la droite selon le ratio spécifié. La valeur doit se situer dans la plage [1,0, 2,0]. La valeur par défaut est 1,0, ce qui indique aucune extension. duration integer (Optional) Durée de la vidéo générée, en secondes. Cette valeur est fixée à 5. prompt_extendbool (Optional) Indique s'il faut activer la réécriture du prompt. Si cette option est activée, un grand modèle de langage (LLM) réécrit le prompt d'entrée. Cela peut améliorer considérablement les résultats pour les prompts courts, mais augmente le temps de traitement.
true (par défaut) : active la réécriture du prompt.false : désactive la réécriture du prompt. (Recommandé)
Si la description textuelle ne correspond pas au contenu vidéo, le modèle risque de mal interpréter l'entrée. Nous vous recommandons de désactiver manuellement l'expansion intelligente et de fournir une description de scène claire et spécifique dans le prompt afin d'améliorer la cohérence et la précision.
seedinteger(Optional) La graine de nombre aléatoire contrôle l'aléatoire du contenu généré par le modèle. La plage de valeurs pour le paramètre seed est [0, 2147483647]. Si vous ne spécifiez pas de graine, celle-ci est générée automatiquement. Pour obtenir des résultats reproductibles, utilisez la même valeur de graine pour plusieurs requêtes. watermark bool(Optional) Indique s'il faut ajouter un filigrane « Généré par IA » dans le coin inférieur droit de l'image.
false (par défaut) : n'ajoute pas de filigrane.true : ajoute un filigrane. |
|
