Wan2.7-Image prend en charge la génération texte-vers-image, texte-vers-ensemble d'images, image-vers-ensemble d'images, l'édition d'images ainsi que la génération par référence multi-images.
Présentation des modèles
Modèle | Description | Spécifications des images générées |
|---|---|---|
wan2.7-image-pro | Wan 2.7 image Pro. Prend en charge la sortie 4K pour la génération texte-vers-image (uniquement, hors ensembles d'images). | Format d'image : PNG. Pour la résolution et les dimensions des images, consultez le paramètre size. |
wan2.7-image | Wan 2.7 image. Offre une génération plus rapide. |
Prérequis
Obtenez une clé API et exportez-la en tant que variable d'environnement.
HTTP synchrone
Renvoie le résultat en une seule requête. Cette méthode est recommandée pour la plupart des cas d'usage.
- Singapore
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
Le modèle wan2.7-image-pro prend en charge la résolution 4K uniquement pour la génération texte-vers-image. L'édition d'images et la génération d'ensembles d'images sont limitées à une résolution maximale de 2K. |
En-têtes | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à application/json. | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Valeurs valides : wan2.7-image-pro, wan2.7-image. | |
input object (Obligatoire)Objet d'entrée.
Propriétés messages array (Obligatoire)Tableau contenant le contenu de la requête. Seules les conversations à tour unique sont prises en charge.
Propriétés role string (Obligatoire)Rôle du message. Doit être défini à user.content array (Obligatoire)Tableau contenant le contenu du message.
Propriétés text stringInvite textuelle. Prend en charge le chinois et l'anglais. Maximum de 5 000 caractères. Chaque caractère, lettre, chiffre ou symbole compte pour une unité. Les caractères excédentaires sont tronqués.image stringURL ou chaîne encodée en Base64 de l'image d'entrée.Limites relatives aux images :
| |
parameters object (Facultatif)Configuration des paramètres du modèle.
Propriétés bbox_list List[List[List[int]]] (Facultatif)Zone de cadre de délimitation pour l'édition interactive.
boolean (Facultatif)Contrôle le mode de génération d'images :
string (Facultatif)Résolution de l'image générée. Deux méthodes mutuellement exclusives sont disponibles :Modèle : wan2.7-image-pro
Les valeurs en pixels de l'image générée peuvent présenter de légères différences par rapport aux valeurs spécifiées.n int (Facultatif)
boolean (Facultatif)Active le mode réflexion. Valeur par défaut : true. Ce paramètre n'est effectif que si le mode ensemble d'images est désactivé et qu'aucune image n'est fournie en entrée. Lorsqu'il est activé, le modèle renforce ses capacités d'inférence afin d'améliorer la qualité des résultats, ce qui augmente toutefois le temps de génération.color_palette array (Facultatif)Thème de couleurs personnalisé. Tableau d'objets comprenant chacun une couleur hexadécimale et une proportion. Doit contenir entre 3 et 10 couleurs. Il est recommandé d'en utiliser 8.Cette option n'est disponible que lorsque le mode ensemble d'images est désactivé (enable_sequential=false).
Propriétés hex string (Obligatoire)Valeur de la couleur au format hexadécimal (HEX).ratio string (Obligatoire)Pourcentage attribué à la couleur. Doit comporter exactement deux décimales (par exemple "25.00%"). La somme de toutes les valeurs ratio doit être égale à 100,00 %.
Cliquez pour afficher un exemple d'entrée 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 d'une même seed produit des sorties similaires. En l'absence de cette valeur, l'algorithme utilise une graine aléatoire.Remarque : La génération d'images repose sur des probabilités. Même avec une seed identique, les résultats peuvent varier. |
Paramètres de la 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. Pensez à enregistrer rapidement les images générées. |
output objectInformations de sortie de la tâche.
Propriétés choices arrayContenu généré par le modèle.
Propriétés finish_reason stringRaison de l'arrêt de la tâche. La valeur stop indique une fin normale.message objectMessage renvoyé par le modèle.
Propriétés role stringRôle du message. Toujours défini à assistant.content array
Propriétés type stringValeur : image.image stringURL de l'image générée. Format : PNG.Ce lien reste valide pendant 24 heures. Téléchargez l'image sans tarder.booleanIndique si la tâche est terminée. Valeur par défaut : false. | |
usage objectStatistiques d'utilisation de la requête. Seuls les résultats réussis sont comptabilisés.
Propriétés image_count integerNombre d'images générées.size stringRésolution de l'image générée. Exemple : 1376*768.input_tokens integerNombre de tokens en entrée (non facturés). La facturation repose sur le nombre d'images.output_tokens integerNombre de tokens en sortie (non facturés). La facturation repose sur le nombre d'images.total_tokens integerNombre total de tokens (non facturés). La facturation repose sur le nombre d'images. | |
request_id stringIdentifiant unique de la requête permettant le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur. |
HTTP asynchrone
Idéal pour les tâches de longue durée. Soumettez une tâche, puis interrogez régulièrement son état et ses résultats.
Étape 1 : Créer une tâche pour obtenir l'ID de tâche
- Singapore
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
Le modèle wan2.7-image-pro prend en charge la résolution 4K uniquement pour la génération texte-vers-image. L'édition d'images et la génération de jeux d'images sont limitées à une résolution maximale de 2K. |
En-têtes | |
Content-Type string (Obligatoire)Type de contenu de la requête. Doit être défini à application/json. | |
Authorization string (Obligatoire)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
X-DashScope-Async string (Obligatoire)Active le traitement asynchrone. Les requêtes HTTP ne prennent en charge que les appels asynchrones. La valeur doit être enable. | |
Corps de la requête | |
model string (Obligatoire)Nom du modèle. Valeurs valides : wan2.7-image-pro, wan2.7-image. | |
input object (Obligatoire)Objet d'entrée.
Propriétés messages array (Obligatoire)Tableau contenant le contenu de la requête. Seules les conversations à tour unique sont prises en charge.
Propriétés role string (Obligatoire)Rôle du message. Doit être défini à user.content array (Obligatoire)Tableau du contenu des messages.
Propriétés text stringInvite textuelle. Prend en charge le chinois et l'anglais. Maximum de 5 000 caractères. Chaque caractère, lettre, chiffre ou symbole compte pour un. Les caractères excédentaires sont tronqués.image stringURL ou chaîne encodée en Base64 de l'image d'entrée.Limites relatives aux images :
| |
parameters object (Facultatif)Paramètres de configuration du modèle.
Propriétés bbox_list List[List[List[int]]] (Facultatif)Zone de cadre de délimitation pour l'édition interactive.
boolean (Facultatif)Contrôle le mode de génération d'images :
string (Facultatif)Résolution de l'image de sortie. Deux méthodes mutuellement exclusives sont prises en charge :Modèle : wan2.7-image-pro
Les valeurs de pixels de l'image de sortie peuvent présenter de légères différences par rapport aux valeurs spécifiées.n int (Facultatif)
boolean (Facultatif)Active le mode réflexion. La valeur par défaut est true. Ce paramètre n'est effectif que lorsque le mode jeu d'images est désactivé et qu'aucune image n'est fournie en entrée. Lorsqu'il est activé, le modèle améliore ses capacités d'inférence pour optimiser la qualité de sortie, ce qui augmente toutefois le temps de génération.color_palette array (Facultatif)Thème de couleur personnalisé. Tableau d'objets comprenant chacun une couleur hexadécimale et un ratio. Doit inclure de 3 à 10 couleurs. 8 couleurs sont recommandées.Cette option n'est disponible que lorsque le mode jeu d'images est désactivé (enable_sequential=false).
Propriétés hex string (Obligatoire)Valeur de couleur au format hexadécimal (HEX).ratio string (Obligatoire)Pourcentage de la couleur. Doit être précis à deux décimales près (par exemple "25.00%"). La somme de toutes les valeurs de ratio doit être égale à 100,00 %.
Cliquez pour afficher un exemple d'entrée 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 |
Enregistrez le task_id afin d'interroger ultérieurement l'état et le résultat de la tâche. |
output objectInformations de sortie de la tâche.
Propriétés task_id stringID de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement en cas d'échec de la requête. Consultez les Codes d'erreur. |
Étape 2 : Interroger le résultat par ID de tâche
- Singapore
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Paramètres de la requête |
Remplacez {task_id} par la valeur task_id retournée lors de l'appel API précédent. La valeur task_id reste valide pour les requêtes pendant 24 heures. Remplacez {WorkspaceId} par votre véritable ID d'espace de travail. |
Headers | |
Authorization string (Required)Authentifie la requête à l'aide d'une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Path parameters | |
task_id string (Required)Identifiant de la tâche. |
Paramètres de la 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 objectInformations de sortie de la tâche.
Properties task_id stringIdentifiant de la tâche. Valide pour les requêtes pendant 24 heures.task_status stringÉtat actuel de la tâche.
Enumeration values
stringHeure de soumission de la tâche. L'heure est exprimé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 exprimé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 exprimée en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.finished booleanIndique si la tâche est terminée. Valeur par défaut : false.choices arrayContenu de sortie généré par le modèle.
Properties finish_reason stringRaison de l'arrêt de la tâche. La valeur stop signale une fin normale.message objectMessage retourné par le modèle.
Properties role stringRôle du message. Toujours assistant.content array
Properties type stringValeurs possibles : text, image.text stringTexte généré.image stringURL de l'image générée. Format : PNG.Ce lien expire au bout de 24 heures. Téléchargez l'image rapidement. | |
usage objectStatistiques d'utilisation de la requête. Seuls les résultats réussis sont comptabilisés.
Properties image_count integerNombre d'images générées.size stringRésolution de l'image générée. Exemple : 1376*768.input_tokens integerNombre de tokens d'entrée (non facturés). La facturation repose sur le nombre d'images.output_tokens integerNombre de tokens de sortie (non facturés). La facturation repose sur le nombre d'images.total_tokens integerNombre total de tokens (non facturés). La facturation repose sur le nombre d'images. | |
request_id stringIdentifiant unique de la requête, utilisé pour le suivi et le dépannage. | |
code stringCode d'erreur. Retourné uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur. | |
message stringMessage d'erreur détaillé. Retourné uniquement en cas d'échec de la requête. Consultez la rubrique Codes d'erreur. |
Python SDK
Les noms des paramètres du SDK correspondent en grande partie à ceux de l'API HTTP.
Les tâches de génération d'images pouvant prendre du temps, le SDK encapsule le workflow asynchrone HTTP. Les appels synchrones et asynchrones sont tous deux pris en charge.
La durée d'une tâche dépend de la longueur de la file d'attente et de l'état du service.Le paramètre
base_url et la clé API dépendent de la région. L'exemple suivant utilise la région Singapore :
- China (Beijing)
- Singapore
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Singapore
- China (Beijing)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Modification d'images
- Synchronous call
- Asynchronous call
Exemple de requête
Exemple de réponse
L'URL est valide pendant 24 heures. Téléchargez l'image sans tarder.
Génération de séquences d'images
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL est valide pendant 24 heures. Téléchargez l'image sans tarder.
Java SDK
Les noms des paramètres du SDK correspondent en grande partie à ceux de l'API HTTP.
Les tâches de génération d'images pouvant prendre du temps, le SDK encapsule le workflow asynchrone HTTP. Les appels synchrones et asynchrones sont tous deux pris en charge.
- Chine (Pékin)
- Singapour
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Singapour
- Chine (Pékin)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.Modification d'images
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL est valide pendant 24 heures. Enregistrez-la sans tarder.
Génération de séries d'images
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL reste valide pendant 24 heures. Pensez à la sauvegarder rapidement.
Facturation et limitations de débit
- Pour consulter le quota gratuit et le prix unitaire du modèle, reportez-vous à la rubrique Tarification des modèles.
- Concernant les limites de débit applicables au modèle, consultez la section Wanxiang.
- Détails de la facturation : la facturation repose sur le nombre d'images générées avec succès. Les appels échoués ainsi que les erreurs de traitement n'entraînent aucun frais et ne consomment pas votre quota gratuit pour les nouveaux utilisateurs.