Le modèle wan2.5 d'édition d'image générale de Wanxiang permet de modifier et de fusionner des images à partir d'instructions textuelles uniquement, tout en préservant la cohérence du sujet entre les modifications.
Présentation du modèle
Capacités du modèle | Exemple d'entrée | Image générée |
|---|---|---|
Édition d'une seule image | ![]() | ![]() Remplacez la robe fleurie par une robe en dentelle de style vintage avec des broderies délicates au col et aux poignets. |
Fusion multi-images | ![]() | ![]() Placez le réveil de l'image 1 à côté du vase sur la table à manger de l'image 2. |
| Nom du modèle | Description du modèle | Spécifications de l'image générée |
|---|---|---|
| wan2.5-i2i-preview | Aperçu Wanxiang 2.5Prend en charge l'édition d'une seule image et la fusion multi-images | Format d'image : PNG.Résolution d'image :
|
Prérequis
Avant d'effectuer un appel, obtenez une clé API et exportez-la comme variable d'environnement. Pour utiliser le SDK, installez le SDK DashScope.
Appel via l'API HTTP
L'édition d'image prend 1 à 2 minutes ; l'API utilise donc une invocation asynchrone : Création de tâche → Interrogation du résultat.
La durée réelle d'exécution varie selon la longueur de la file d'attente et la charge du service.
Étape 1 : Créer une tâche et obtenir l'ID de tâche
Région Singapour : POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Région Pékin : 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.
- Une fois la tâche créée, utilisez le
task_idretourné pour interroger le résultat. Cetask_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, reportez-vous à Appeler des API avec Postman ou cURL.
Paramètres de requête | |
En-têtes de requête | |
Content-Type string (Required)The content type of the request. Must be application/json. | |
Authorization string (Required)Authenticates the request with a Model Studio API key. Example: Bearer sk-xxxx. | |
X-DashScope-Async string (Required)Enables asynchronous processing. HTTP requests support only asynchronous calls. Must be enable. | |
Corps de la requête | |
model string (required)Nom du modèle. Modèles pris en charge et tarifs.Valeur d'exemple : wan2.5-i2i-preview. | |
input object (required)Champs d'entrée tels que le prompt et les images.
Propriétés prompt string (required)Prompt positif décrivant les éléments et caractéristiques visuelles à inclure dans l'image générée.Prend en charge le chinois et l'anglais. Maximum : 2 000 caractères (chaque caractère compte pour un) ; le surplus est tronqué.Pour des conseils sur la rédaction de prompts, consultez le Guide de prompts texte-vers-image.Valeur d'exemple : Un chat orange joyeux assis, réaliste et détaillé.images array of string (required)Tableau d'URL d'images.
string (optional)Prompt négatif décrivant les éléments à exclure de l'image.Prend en charge le chinois et l'anglais. Maximum : 500 caractères ; le surplus est tronqué.Valeur d'exemple : basse résolution, erreurs, meilleure qualité, mauvaise qualité, incomplet, doigts supplémentaires, mauvaises proportions. | |
parameters object (optional)Contrôle la résolution, la réécriture du prompt et le filigrane.
Propriétés size string (optional)Définit la résolution de l'image générée au format width×height. Valeur par défaut : 1280×1280.
Résolutions et rapports d'aspect recommandés
size est omis, la valeur par défaut est de 1280×1280 pixels avec un rapport d'aspect approximatif :
integer (optional)Nombre d'images à générer. Plage : 1–4. Valeur par défaut : 4. Définissez cette valeur à 1 lors des tests afin de maîtriser les coûts.watermark boolean (optional)Ajoute un filigrane « AI Generated » dans le coin inférieur droit.
boolean (optional)Active la réécriture du prompt basée sur un LLM pour améliorer la qualité de l'image. Augmente la latence.
integer (optional)Graine de nombre aléatoire. Plage valide : [0, 2147483647].Si ce paramètre est omis, une graine aléatoire est générée. S'il est spécifié, des graines séquentielles sont attribuées à chacune des n images en fonction de n. Par exemple, si n=4, les graines seront : seed, seed+1, seed+2, seed+3.Pour améliorer la reproductibilité, fixez la valeur de la graine.Des graines identiques ne garantissent pas des résultats identiques en raison de la nature probabiliste de la génération. |
Paramètres de réponse |
Conservez 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 requêtes pendant 24 heures.task_status stringÉtat de la tâche.
Valeurs d'énumération
| |
request_id stringIdentifiant unique de requête pour le suivi et le dépannage. | |
code stringCode d'erreur. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. | |
message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. |
Étape 2 : Interroger les résultats à l'aide de l'ID de tâche
- China (Beijing)
- Singapore
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Singapore
- China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.- Recommandation d'interrogation : la génération d'image 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 de résultat : après la réussite d'une tâche, une URL d'image valide pendant 24 heures est retournée. Téléchargez et enregistrez l'image dans un stockage permanent, tel que OSS.
Paramètres de requête |
Remplacez 86ecf553-d340-4e21-xxxxxxxxx par votre véritable task_id.Les clés API diffèrent selon les régions. Pour plus d'informations, consultez Obtenir une clé API. Si vous utilisez un modèle dans la région Chine (Pékin), remplacez |
En-têtes de requête | |
Authorization string (Required)Authenticates the request with a Model Studio API key. Example: Bearer sk-xxxx. | |
Paramètre de chemin URL | |
task_id string (Required)ID de la tâche. |
Paramètres de réponse |
Les URL d'images ne sont valides que pendant 24 heures, puis elles sont automatiquement supprimées. Enregistrez rapidement les images générées. |
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
stringHeure de soumission de la tâche. L'heure est 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 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 en UTC+8 et le format est AAAA-MM-JJ HH:mm:ss.SSS.results array of objectListe des résultats de la tâche, comprenant les URL d'images, les prompts et les détails d'erreur en cas d'échecs partiels.
Propriétés orig_prompt stringPrompt d'entrée original, correspondant au paramètre de requête prompt.actual_prompt stringPrompt optimisé utilisé lorsque la réécriture de prompt est activée. Non retourné lorsqu'elle est désactivée.url stringURL de l'image générée.code stringCode d'erreur pour les images ayant échoué. Retourné uniquement en cas d'échecs partiels.message stringMessage d'erreur pour les images ayant échoué. Retourné uniquement en cas d'échecs partiels.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. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur.message stringMessage d'erreur détaillé. Retourné uniquement pour les requêtes ayant échoué. Consultez Codes d'erreur. | |
usage objectStatistiques d'utilisation. Ne comptabilise que les résultats réussis.
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 requête pour le suivi et le dépannage. |
Appel via le SDK DashScope
Les paramètres du SDK correspondent à ceux de l'appel via l'API HTTP, adaptés à chaque langage.
L'édition d'image prend 30 à 60 secondes. Le SDK encapsule le flux HTTP asynchrone et prend en charge les appels synchrones et asynchrones.
La durée réelle d'exécution varie selon la longueur de la file d'attente et la charge du service.
Appel via le SDK Python
- Appel synchrone
- Appel asynchrone
Exemple de requête
Cet exemple prend en charge trois méthodes d'entrée d'image : URL publique, encodage Base64 et chemin de fichier local.Exemple de réponse
Les URL d'images expirent après 24 heures. Téléchargez les images sans tarder.
Appel via le SDK Java
- Appel synchrone
- Appel asynchrone
Exemple de requête
Cet exemple prend en charge trois méthodes d'entrée d'image : URL publique, encodage Base64 et chemin de fichier local.Exemple de réponse
Les URL d'images expirent après 24 heures. Téléchargez les images sans tarder.
Limites
- Rétention des données : les ID de tâche et les URL d'images expirent tous deux après 24 heures. Vous ne pouvez plus les interroger ni les télécharger après expiration.
- Modération de contenu : tous les prompts, images d'entrée et images générées font l'objet d'une modération de contenu. Les requêtes contenant du contenu interdit retournent des erreurs telles que « IPInfringementSuspect » ou « DataInspectionFailed ». Consultez Informations sur les erreurs pour plus de détails.
Codes d'erreur
Si l'appel du modèle échoue et retourne un message d'erreur, consultez Codes d'erreur pour résoudre le problème.
FAQ
Q : J'utilisais auparavant l'édition d'image générale 2.1. Dois-je modifier mes appels SDK pour utiliser wan2.5 ?
R : Oui, la conception des paramètres diffère entre les versions :- Édition d'image générale 2.1 : nécessite à la fois les paramètres
promptetfunction. - Édition d'image générale 2.5 : nécessite uniquement le paramètre
prompt. Décrivez toutes les modifications sous forme de texte. Le paramètrefunctionn'est plus pris en charge ni nécessaire.



