Wan2.6 prend en charge l'entrée multi-images, l'édition d'images et la sortie texte-image entrelacée.
Présentation du modèle
Modèle | Description | Spécifications des images de sortie |
|---|---|---|
wan2.6-image | Édite des images et génère une sortie texte-image entrelacée. | Format d'image : PNG La résolution et les dimensions de l'image se configurent via le paramètre size. |
Prérequis
Obtenez une clé API et exportez la clé API en tant que variable d'environnement.
HTTP synchrone
Renvoie les résultats en une seule requête. Recommandé pour la plupart des scénarios.
- Singapore
- US (Virginia)
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationLors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Le périmètre de déploiement mondial (région Francfort) prend uniquement en charge les appels asynchrones .
Paramètres de requête |
|
En-têtes de requête | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être application/json. | |
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
X-DashScope-SSEstring (Facultatif)Active la sortie en streaming.
| |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Définissez cette valeur sur wan2.6-image. | |
input object (Obligatoire)Configuration d'entrée.
Propriétés messages array (Obligatoire)Tableau du contenu de la requête. Seules les conversations à tour unique sont prises en charge : fournissez une seule paire rôle-contenu.
Propriétés role string (Obligatoire)Rôle du message. Définissez cette valeur sur user.contentarray (Obligatoire)Tableau du contenu du message.
Propriétés text string(Obligatoire)Prompt positif décrivant le contenu, le style et la composition souhaités pour l'image.Prend en charge le chinois et l'anglais. Maximum de 2 000 caractères (chaque caractère chinois, lettre, chiffre ou symbole compte pour un). Tronqué automatiquement en cas de dépassement.Exemple : Générer un sauté de tomates et d'œufs basé sur le style de cette image.Remarque : Le tableau content doit contenir exactement un objet avec un champ text.imagestring(Facultatif)URL ou chaîne encodée en Base64 de l'image d'entrée.Contraintes relatives aux images :
| |
parameters object (Facultatif)Paramètres de génération.
Propriétés negative_prompt string (facultatif)Prompt négatif décrivant les éléments à exclure de l'image.Prend en charge le chinois et l'anglais. Longueur maximale de 500 caractères. Les caractères excédentaires sont tronqués automatiquement.Exemple : Faible résolution, basse qualité, membres déformés, doigts mal formés, couleurs sursaturées, aspect cireux, absence de détails faciaux, surfaces trop lisses, apparence générée par IA. Composition chaotique. Texte flou ou déformé.size string (Facultatif)Résolution de l'image de sortie. Deux méthodes sont disponibles : référencer les proportions de l'image d'entrée ou spécifier directement les dimensions.Si enable_interleave=false (mode édition d'image) :
enable_interleave=true (mode sortie texte-image entrelacée) :
Résolutions recommandées pour les rapports d'aspect courants
bool (Facultatif)Contrôle le mode de génération d'images :
integer (Facultatif)Nombre d'images à générer. Le comportement dépend de enable_interleave :
integer (Facultatif)Uniquement effectif en mode texte-image entrelacé (enable_interleave=true).
bool (Facultatif)Uniquement effectif en mode édition d'image (enable_interleave = false).Active la réécriture intelligente du prompt. Optimise uniquement le prompt positif ; le prompt négatif reste inchangé.
bool (Facultatif)Active la sortie en streaming. Obligatoire (définir sur true) lorsque enable_interleave=true.
bool (Facultatif)Ajoute un filigrane dans le coin inférieur droit de l'image avec le texte fixe « AI Generated ».
integer (facultatif)Graine de nombre aléatoire. Plage valide : [0,2147483647].L'utilisation de la même seed produit des sorties similaires. En cas d'omission, l'algorithme utilise une graine aléatoire.Remarque : La génération d'images est probabiliste. Même avec la même seed, les résultats peuvent varier. |
Paramètres de réponse |
Les données de la tâche (statut et URL des images) ne sont conservées que pendant 24 heures avant d'être automatiquement supprimées. Enregistrez les images générées sans tarder. |
output objectSortie de la tâche.
Propriétés choices array of objectContenu de sortie généré par le modèle.
Propriétés finish_reason stringRaison de la fin de la tâche.Scénario de sortie non-streaming : s'arrête naturellement avec stop.Scénario de sortie en streaming : ce paramètre indique si le flux de données a terminé sa transmission.
objectMessage renvoyé par le modèle.
Propriétés role stringRôle du message, fixé à assistant.contentarray
Propriétés type stringType de sortie. Valeurs énumérées : text, image.text stringTexte généré.image stringURL de l'image générée au format PNG.Le lien expire après 24 heures. Téléchargez et enregistrez l'image rapidement.boolIndicateur de fin de requête.
| |
usage objectStatistiques de sortie. Comptabilise uniquement les résultats réussis.
Propriétés image_count integerNombre d'images générées.size stringRésolution des images générées. Exemple : 1376*768.input_tokens integerFacturation basée sur le nombre d'images.
integerFacturation basée sur le nombre d'images.
integerFacturation basée sur le nombre d'images.
| |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement pour les requêtes ayant échoué. Consultez la rubrique Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez la rubrique Codes d'erreur. |
HTTP asynchrone
Processus : Créer une tâche → Interroger les résultats
Étape 1 : Créer une tâche et obtenir son ID
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationLors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Une fois la tâche créée, utilisez le
task_idrenvoyé pour interroger le résultat. Letask_idreste valide pendant 24 heures. Ne créez pas de tâches en double. Utilisez plutôt l'interrogation pour récupérer le résultat. - Pour un guide destiné aux débutants, consultez Appeler des API avec Postman ou cURL.
Paramètres de requête | |
En-têtes de requête | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être application/json. | |
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
X-DashScope-Asyncstring(Obligatoire)Commutateur de mode asynchrone. Doit être défini à enable. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle.Exemple : wan2.6-image | |
input object (Obligatoire)Configuration d'entrée.
Propriétés messages array (Obligatoire)Tableau du contenu de la requête. Seules les conversations à tour unique sont prises en charge — fournissez une paire rôle-contenu. Les conversations multi-tours ne sont pas prises en charge.
Propriétés role string (Obligatoire)Rôle du message. Définissez-le à user.contentarray (Obligatoire)Tableau du contenu du message.
Propriétés text string(Obligatoire)Prompt positif décrivant le contenu, le style et la composition souhaités pour l'image.Prend en charge le chinois et l'anglais. Maximum de 2 000 caractères (chaque caractère chinois, lettre, chiffre ou symbole compte pour un). Tronqué automatiquement en cas de dépassement.Exemple : Générer un sauté de tomates et d'œufs basé sur le style de cette image.Remarque : Le tableau content doit contenir exactement un objet avec un champ text.imagestring(Facultatif)URL ou chaîne encodée en Base64 de l'image d'entrée.Contraintes relatives à l'image :
| |
parameters object (Facultatif)Paramètres de génération.
Propriétés negative_prompt string (facultatif)Un prompt négatif décrivant ce que vous ne voulez pas voir apparaître dans l'image.Prend en charge le chinois et l'anglais. La longueur maximale est de 500 caractères. Les caractères excédentaires sont tronqués automatiquement.Exemple : Faible résolution, basse qualité, membres déformés, doigts malformés, couleurs trop saturées, aspect cireux, absence de détails faciaux, surfaces trop lisses, apparence générée par IA. Composition chaotique. Texte flou ou déformé.size string (Facultatif)Résolution de l'image de sortie. Prend en charge deux méthodes : référence aux proportions de l'image d'entrée ou spécification directe des dimensions.Lorsque enable_interleave=false (mode édition d'image) :
enable_interleave=true (mode sortie texte-image entrelacée) :
Résolutions recommandées pour les rapports d'aspect courants
bool (Facultatif)Contrôle le mode de génération d'images :
integer (Facultatif)Nombre d'images à générer. Le comportement dépend de enable_interleave :
integer (Facultatif)Effectif uniquement en mode texte-image entrelacé (enable_interleave=true).
bool (Facultatif)Effectif uniquement en mode édition d'image (enable_interleave = false).Active la réécriture intelligente du prompt. Optimise uniquement le prompt positif ; le prompt négatif reste inchangé.
bool (Facultatif)Ajoute un filigrane dans le coin inférieur droit de l'image avec le texte fixe « AI Generated ».
integer (facultatif)Graine de nombre aléatoire. Plage valide : [0,2147483647].L'utilisation de la même seed produit des sorties similaires. Si omis, l'algorithme utilise une graine aléatoire.Remarque : La génération d'images est probabiliste. Même avec la même seed, les résultats peuvent varier. |
Paramètres de réponse |
Conservez le task_id afin d'interroger ultérieurement l'état et le résultat de la tâche. |
output objectSortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. |
Étape 2 : Interroger les résultats à l'aide de l'ID de tâche
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable workspace ID.- Recommandation d'interrogation : La génération d'images prend du temps. Mettez en place un mécanisme d'interrogation avec un intervalle raisonnable, par exemple 10 secondes.
- Transition d'état de la tâche : PENDING → RUNNING → SUCCEEDED ou FAILED.
- Lien du résultat : Une fois la tâche terminée avec succès, une URL d'image valide pendant 24 heures est renvoyée. Téléchargez et enregistrez l'image dans un stockage permanent, tel que OSS.
Paramètres de requête |
Remplacez {task_id} par la valeur task_id renvoyée lors de l'appel API précédent. Le task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable workspace ID. |
En-têtes de requête | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin URL | |
task_id string (Obligatoire)Identifiant de la tâche. |
Paramètres de réponse |
Les données de la tâche (état et URL des images) ne sont conservées que pendant 24 heures avant d'être automatiquement supprimées. Pensez à enregistrer rapidement les images générées. |
output objectInformations de sortie de la tâche.
Propriétés task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est indiquée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.scheduled_time stringHeure d'exécution de la tâche. L'heure est indiquée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.end_time stringHeure de fin de la tâche. L'heure est indiquée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.finished boolIndicateur de fin de requête.
array of objectContenu de sortie généré par le modèle.
Propriétés finish_reason stringRaison de la fin de la tâche. L'arrêt naturel se fait avec stop.message objectMessage renvoyé par le modèle.
Propriétés role stringRôle du message, fixé à assistant.contentarray
Propriétés type stringType de sortie. Valeurs énumérées : text, image.text stringTexte généré.image stringURL de l'image générée au format PNG.Le lien expire après 24 heures. Téléchargez et enregistrez l'image sans tarder. | |
usage objectStatistiques de sortie. Comptabilise uniquement les résultats réussis.
Propriétés image_count integerNombre d'images générées.size stringRésolution des images générées. Exemple : 1376*768.input_tokens integerNombre de tokens en entrée. Facturé selon le nombre d'images. Actuellement fixé à 0.output_tokens integerNombre de tokens en sortie. Facturé selon le nombre d'images. Actuellement fixé à 0.total_tokensintegerNombre total de tokens. Facturé selon le nombre d'images. Actuellement fixé à 0. | |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez la section Codes d'erreur. |
DashScope Python SDK
Les paramètres du SDK correspondent à ceux de l'interface HTTP, adaptés aux conventions de chaque langage.
Le SDK gère les appels asynchrones en interne et prend en charge les invocations synchrones et asynchrones.
La durée réelle varie selon la longueur de la file d'attente et la charge du service.Le paramètre
base_url et la clé API dépendent de la région. Exemple d'appel depuis la région Singapour :
- Singapore
- US (Virginia)
- China (Beijing)
- Germany (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable workspace ID.Le périmètre de déploiement mondial (région Francfort) ne prend en charge que les appels asynchrones.
Modification d'images
- Synchronous
- Asynchronous
Exemple de requête
Exemple de réponse
L'URL expire après 24 heures. Téléchargez les images sans tarder.
Sortie texte-image entrelacée
- Synchrone (streaming uniquement)
- Asynchrone
Exemple de requête
Exemple de réponse
L'URL expire après 24 heures. Téléchargez les images sans tarder.
DashScope Java SDK
Les paramètres du SDK correspondent à ceux de l'interface HTTP et sont encapsulés selon les conventions de chaque langage.
Le SDK gère les appels asynchrones en interne et prend en charge les invocations synchrones et asynchrones.
La durée réelle dépend de la longueur de la file d'attente et de la charge du service.La
base_url et la clé API ne sont pas interchangeables entre les régions. Exemples pour la région Singapour :
- Singapour
- États-Unis (Virginie)
- Chine (Pékin)
- Allemagne (Francfort)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Le périmètre de déploiement mondial (région de Francfort) prend uniquement en charge les appels asynchrones.
Modification d'image
- Synchrone
- Asynchrone
Exemple de requête
Exemple de réponse
L'URL expire après 24 heures. Téléchargez les images sans tarder.
Sortie texte-image entrelacée
- Appel synchrone (streaming uniquement)
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL expire après 24 heures. Téléchargez les images sans tarder.
Limites
- Validité des données : Le
task_idde la tâche et l'urlde l'image ne sont conservés que pendant 24 heures. Passé ce délai, il n'est plus possible de les interroger ni de les télécharger. - Modération du contenu : Le
promptd'entrée et l'image générée font tous deux l'objet d'une modération. Tout contenu non conforme déclenche une erreurIPInfringementSuspectouDataInspectionFailed. Consultez la rubrique Codes d'erreur.
Facturation et limites de taux
- Pour les quotas gratuits et les tarifs, reportez-vous à la rubrique Tarification des modèles.
- Concernant les limites de taux applicables aux modèles, consultez la rubrique Wanxiang.
- La facturation s'applique uniquement par image générée avec succès. Les appels échoués ne sont pas facturés et ne consomment pas le quota gratuit.