Cette rubrique décrit les paramètres d'entrée et de sortie du modèle Wan d'édition d'image générale.
- Stylisation d'image : Stylisation globale et locale.
- Édition du contenu de l'image : Édition basée sur des instructions (ajout ou modification du contenu de l'image via des instructions sans spécifier de zone), inpainting (ajout, suppression ou modification de contenu dans une zone définie) et suppression de filigranes textuels (chinois et anglais).
- Optimisation de la taille et de la résolution de l'image : Expansion d'image (agrandissement proportionnel) et super résolution (amélioration vers la haute définition).
- Traitement des couleurs de l'image : Colorisation (conversion d'images en noir et blanc ou en niveaux de gris vers la couleur).
- Génération basée sur une image de référence : Génération d'image à partir d'un croquis (extraction d'un croquis depuis l'image d'entrée puis génération d'une nouvelle image basée sur ce croquis) et génération par référence de personnage de dessin animé.
Présentation du modèle
Modèle | Prix | Limite de taux (partagée entre les comptes racines et les utilisateurs RAM) | |
|---|---|---|---|
RPS de soumission de tâche | Tâches simultanées | ||
wanx2.1-imageedit | 0,020070 $/image | 2 | 2 |
Effets du modèle
Fonctionnalité | Image d'entrée | Invite d'entrée | Image de sortie |
|---|---|---|---|
Stylisation globale | ![]() | Convertir en style livre d'images français | ![]() |
Stylisation locale | ![]() | Changer la maison en style bois. | ![]() |
Édition basée sur des instructions | ![]() | Changer ses cheveux en rouge. | ![]() |
Inpainting | Image d'entrée ![]() Image de masque d'entrée (le blanc correspond à la zone masquée) ![]() | Un lapin en céramique tenant une fleur en céramique. | Image de sortie ![]() |
Suppression de filigrane textuel | ![]() | Supprimer le texte de l'image. | ![]() |
Expansion d'image | ![]() | Une fée verte. | ![]() |
Super résolution | Image floue ![]() | Super résolution. | Image nette ![]() |
Colorisation | ![]() | Fond bleu, feuilles jaunes. | ![]() |
Génération d'image à partir d'un croquis | Image d'entrée ![]() | Un salon dans un style nordique minimaliste. | Extraire le croquis de l'image originale et générer une nouvelle image ![]() |
Génération par référence de personnage de dessin animé | Image de référence d'entrée (personnage de dessin animé) ![]() | Le personnage de dessin animé jette un coup d'œil prudent, observant un joyau bleu étincelant dans la pièce. | Image de sortie ![]() |
Prérequis
Appelez l'API Wan d'édition d'image générale via HTTP ou le SDK DashScope.
Avant tout appel, obtenez une clé API et exportez-la en tant que variable d'environnement.
Pour appeler l'API avec le SDK, installez le SDK DashScope. Le SDK est disponible pour Python et Java.
HTTP
Les modèles d'image nécessitent un temps de traitement important. Afin d'éviter les délais d'expiration, les appels HTTP prennent uniquement en charge la récupération asynchrone des résultats. Deux requêtes sont nécessaires :
- Créer une tâche pour obtenir un ID de tâche : Envoyez une requête de création de tâche. La réponse renvoie un ID de tâche (
task_id). - Interroger le résultat à l'aide de l'ID de tâche : Utilisez l'ID de tâche obtenu à l'étape précédente pour interroger l'état et le résultat de la tâche. En cas de succès, la réponse renvoie une URL d'image valide pendant 24 heures.
Le modèle d'édition d'image générale traite une requête en 5 à 15 secondes environ. Le délai réel dépend du nombre de tâches en attente et des conditions réseau. Veuillez patienter jusqu'à l'obtention du résultat.
Étape 1 : Créer une tâche pour obtenir un ID de tâche
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
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-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, par exemple wanx2.1-imageedit. | |
input object (Obligatoire)Informations d'entrée de base (invite).
Propriétés prompt string(Obligatoire)Invite utilisée pour décrire les éléments souhaités et les caractéristiques visuelles de l'image générée.Prend en charge le chinois et l'anglais. Longueur maximale : 800 caractères. Chaque caractère chinois ou lettre compte pour un caractère. Les caractères excédentaires sont automatiquement tronqués.Les invites varient selon les fonctionnalités. Nous vous recommandons de consulter les conseils de rédaction d'invites correspondants pour chaque fonctionnalité.function string(Obligatoire)Fonctionnalité d'édition d'image. Les fonctionnalités suivantes sont actuellement prises en charge :
string (Obligatoire)URL ou données encodées en Base64 de l'image d'entrée.Exigences relatives à l'image :
string (Facultatif)Ce paramètre est requis uniquement lorsque function est défini sur description_edit_with_mask (inpainting). Il n'est pas nécessaire pour les autres fonctionnalités.URL ou données encodées en Base64 de l'image de masque.Vous pouvez transmettre une URL accessible publiquement (HTTP/HTTPS) ou une chaîne encodée en Base64. Pour plus d'informations, consultez Formats pris en charge.Exigences relatives à l'image de masque :
| |
parameters object (Facultatif)Paramètres de traitement de l'image.
Propriétés
n integer (Facultatif)Nombre d'images à générer. Plage de valeurs : 1 à 4. Valeur par défaut : 1.seedinteger(Facultatif)Graine aléatoire utilisée pour contrôler l'aléatoire du contenu généré par le modèle. Plage de valeurs : [0, 2147483647].Si aucune valeur n'est fournie, l'algorithme génère automatiquement un nombre aléatoire comme graine. Pour maintenir une relative stabilité du contenu généré, utilisez la même valeur de graine.watermark bool (Facultatif)Indique s'il faut ajouter un filigrane. Le filigrane se trouve dans le coin inférieur droit de l'image et affiche « Generated by AI ».
|
Paramètres de réponse |
Enregistrez le task_id pour interroger 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 interrogations 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 pour les requêtes ayant échoué. Consultez Codes d'erreur. | |
message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. |
Étape 2 : Interroger le résultat par ID de tâche
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}
Remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
Paramètres de requête |
Remplacez 86ecf553-d340-4e21-xxxxxxxxx par votre véritable task_id. |
En-têtes de requête | |
Authorization string (Obligatoire)Authentifie la requête avec une clé API Model Studio. Exemple : Bearer sk-xxxx. | |
Paramètres de chemin | |
task_id string (Obligatoire)ID de la tâche. |
Paramètres de réponse |
Les données de la tâche (état de la tâche et URL des images) ne sont conservées que pendant 24 heures, puis automatiquement supprimées. Enregistrez rapidement les images générées. |
outputobjectInformations de sortie de la tâche.
Propriétés task_id stringID de la tâche. Valide pour les interrogations pendant 24 heures.task_status stringÉtat de la tâche.
Valeurs d'énumération
stringHeure de soumission de la tâche. L'heure est au format 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 au format 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 au format UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.results array objectListe des résultats de la tâche, comprenant les URL des images et les messages d'erreur pour les tâches ayant partiellement échoué.
Structure des données objectStatistiques du résultat de la tâche.
Propriétés TOTAL integerNombre total de tâches.SUCCEEDED integerNombre de tâches réussies.FAILED integerNombre de tâches ayant échoué.stringCode d'erreur. Renvoyé uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.message stringMessage d'erreur détaillé. Renvoyé uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. | |
usage objectStatistiques des informations de sortie. Seuls les résultats réussis sont comptabilisés.
Propriétés image_count integerNombre d'images générées avec succès. Facturation : Coût = Nombre d'images × Prix unitaire. | |
request_id stringIdentifiant unique de la requête pour le suivi et le dépannage. |
SDK DashScope
Assurez-vous d'avoir installé la dernière version du SDK DashScope. Dans le cas contraire, une erreur d'exécution pourrait survenir.
Le SDK DashScope prend actuellement en charge Python et Java.
Les noms des paramètres dans le SDK sont globalement cohérents avec ceux de l'API HTTP. La structure des paramètres dépend de l'encapsulation du SDK pour les différents langages. Pour la description des paramètres, consultez Appel HTTP.
Le traitement des modèles vidéo prenant beaucoup de temps, le service utilise une approche asynchrone. Le SDK fournit une enveloppe prenant en charge à la fois les appels synchrones et asynchrones.
Le modèle d'édition d'image générale traite une requête en 5 à 15 secondes environ. Le délai réel dépend du nombre de tâches en attente et des conditions réseau. Veuillez patienter jusqu'à l'obtention du résultat.
SDK Python
Lors de l'utilisation du SDK Python pour traiter des fichiers image, fournissez une image en entrée selon l'une des trois méthodes suivantes. Choisissez la méthode la mieux adaptée à votre scénario.
- URL publique : Une URL d'image accessible publiquement utilisant le protocole HTTP ou HTTPS.
- Encodage Base64 : Transmettez la chaîne de fichier encodée en Base64 au format
data:{MIME_type};base64,{base64_data}. - Chemin de fichier local : Prend en charge les chemins absolus et relatifs. Consultez le tableau suivant pour les formats de chemin de fichier valides.
Système | Chemin de fichier à transmettre | Exemple (chemin absolu) | Exemple (chemin relatif) |
|---|---|---|---|
Linux ou macOS | file://{chemin absolu ou relatif du fichier} | file:///home/images/test.png | file://./images/test.png |
Windows | file://D:/images/test.png | file://./images/test.png |
Exemple de code
pip install -U dashscope. Consultez Installer le SDK.- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL est valide pendant 24 heures. Téléchargez l'image rapidement.
SDK Java
Lors de l'utilisation du SDK Java pour traiter des fichiers image, fournissez une image en entrée selon l'une des trois méthodes suivantes. Choisissez la méthode la mieux adaptée à votre scénario.
- URL publique : Une URL d'image accessible publiquement utilisant le protocole HTTP ou HTTPS.
- Encodage Base64 : Transmettez la chaîne de fichier encodée en Base64 au format
data:{MIME_type};base64,{base64_data}. - Chemin de fichier local : Seuls les chemins absolus sont pris en charge. Consultez le tableau suivant pour les formats de chemin de fichier valides.
Système | Chemin de fichier à transmettre | Exemple |
|---|---|---|
Linux ou macOS | file://{chemin absolu du fichier} | file:///home/images/test.png |
Windows | file:///{chemin absolu du fichier} | file:///D:/images/test.png |
Exemple de code
- Appel synchrone
- Appel asynchrone
Exemple de requête
Exemple de réponse
L'URL est valide pendant 24 heures. Téléchargez l'image rapidement.
Codes d'erreur
Si l'appel du modèle échoue et renvoie un message d'erreur, consultez Codes d'erreur pour résoudre le problème.
Cette API possède également des codes d'état spécifiques, comme indiqué dans le tableau suivant.
Code d'état HTTP | Code d'erreur API (code) | Message d'erreur API (message) | Description |
|---|---|---|---|
400 | InvalidParameter | InvalidParameter | Les paramètres de la requête sont invalides. |
400 | IPInfringementSuspect | Input data is suspected of being involved in IP infringement. | Les données d'entrée (telles que l'invite ou l'image) sont soupçonnées de porter atteinte à la propriété intellectuelle. Vérifiez les entrées pour vous assurer qu'elles ne contiennent pas de contenu présentant un risque d'infraction. |
400 | DataInspectionFailed | Input data may contain inappropriate content. | Les données d'entrée (telles que l'invite ou l'image) peuvent contenir du contenu inapproprié. Modifiez les entrées et réessayez. |
500 | InternalError | InternalError | Le service présente une anomalie. Réessayez afin d'écarter un problème ponctuel. |
Formats d'image d'entrée
Formats pris en charge
Les images d'entrée prennent en charge plusieurs formats de chaîne, comme indiqué dans le tableau suivant.
| Méthode d'appel | HTTP | SDK Python | SDK Java |
|---|---|---|---|
| Méthodes d'entrée d'image prises en charge |
|
|
|
- Fournissez une adresse d'image accessible publiquement. Les protocoles HTTP et HTTPS sont pris en charge.
- Exemple :
https://xxxx/img.png
data:{MIME_type};base64,{base64_data}.
- Pour le code de conversion, consultez Exemple de code
- {MIME_type} : Type de média de l'image, qui doit correspondre au format du fichier
- {base64_data} : Chaîne encodée en Base64 du fichier image
-
Référence des types MIME :
Format d'image
Type MIME
JPEG
image/jpeg
JPG
image/jpeg
PNG
image/png
BMP
image/bmp
TIFF
image/tiff
WEBP
image/webp
-
Exemple :
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABDg......Remarque : La chaîne Base64 ci-dessus est tronquée à titre d'exemple. Dans la pratique, transmettez la chaîne encodée complète.
- HTTP ne prend pas en charge les chemins de fichiers locaux. Seuls le SDK Python et le SDK Java permettent cette méthode.
- Pour les règles relatives aux chemins de fichiers locaux, consultez SDK Python et SDK Java.




















