Qwen-Image Edit prend en charge l'entrée et la sortie de plusieurs images. Modifiez du texte dans des images, ajoutez, supprimez ou déplacez des objets, changez la pose des sujets, transférez des styles et améliorez les détails, le tout via des invites en langage naturel.
Présentation du modèle
Image d'entrée 1 | Image d'entrée 2 | Image d'entrée 3 | Images de sortie (multiples) | |
|---|---|---|---|---|
![]() | ![]() | ![]() | ![]() | ![]() |
Invite : La fille de l'Image 1 porte la robe noire de l'Image 2 et adopte la posture assise de l'Image 3.
| Nom du modèle | Description du modèle | Spécifications de l'image de sortie |
|---|---|---|
qwen-image-2.0-pro RecommandéIl possède actuellement les mêmes capacités que qwen-image-2.0-pro-2026-04-22. | La série Pro des modèles de génération et d'édition d'images Qwen offre des capacités améliorées en matière de rendu de texte, de textures réalistes et de respect sémantique.Pour la génération d'images, consultez Qwen-Text to Image. | Résolution de l'image :
|
qwen-image-2.0-pro-2026-06-22 Recommandé | ||
| qwen-image-2.0-pro-2026-04-22 | ||
| qwen-image-2.0-pro-2026-03-03 | ||
qwen-image-2.0 RecommandéIl possède actuellement les mêmes capacités que qwen-image-2.0-2026-03-03. | Il s'agit de la version accélérée du modèle de génération et d'édition d'images Qwen, offrant un équilibre entre performance et rapidité de réponse.Pour la génération d'images, consultez Qwen-Text to Image. | |
qwen-image-2.0-2026-03-03 Recommandé |
Avant d'appeler l'API, vérifiez la Liste des modèles pour connaître les modèles pris en charge dans chaque région.
Prérequis
Avant tout appel, obtenez une clé API et exportez-la en tant que variable d'environnement.
Pour appeler l'API à l'aide du SDK, installez le SDK DashScope. Le SDK est disponible pour Python et Java.
Appel HTTP
Région Singapour :POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Région Pékin :POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Lors de l'appel, remplacez {WorkspaceId} par votre véritable ID d'espace de travail.
Paramètres de la requête |
Cet exemple utilise le modèle qwen-image-2.0-pro pour générer deux images. |
En-têtes de la requête | |
Content-Type string (Obligatoire)Le 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. | |
Corps de la requête | |
model string (Obligatoire)Le nom du modèle. Exemple : qwen-image-2.0-pro. | |
input object (Obligatoire)L'objet d'entrée contient le champ suivant :
Propriété messages array (Obligatoire)Tableau du contenu de la requête. Seules les conversations à tour unique sont actuellement prises en charge, le tableau doit donc contenir exactement un objet avec les propriétés role et content.
Propriété role string (Obligatoire)Le rôle de l'expéditeur du message. Doit être user.contentarray (Obligatoire)Le contenu du message se compose d'une à trois images au format {"image": "..."} et d'une instruction d'édition unique au format {"text": "..."}.
Propriété image string (Obligatoire)L'URL ou les données encodées en Base64 de l'image d'entrée. Vous pouvez fournir une à trois images.Pour une entrée multi-images, l'ordre des images correspond à la séquence du tableau. Le rapport d'aspect de l'image de sortie est basé sur la dernière image.Exigences relatives aux images :
string(Obligatoire)Une invite positive décrivant le contenu, le style et la composition souhaités pour l'image de sortie.Prend en charge le chinois et l'anglais. La série qwen-image-2.0 accepte jusqu'à 1 300 tokens. Le système tronque les tokens excédentaires.Remarque : Le tableau content doit contenir exactement un objet text. Sinon, une erreur se produit. | |
parameters object (Facultatif)Paramètres supplémentaires pour contrôler la génération d'images.
Propriété n integer (Facultatif)Le nombre d'images de sortie. Par défaut : 1.Pour les modèles de la série qwen-image-2.0, vous pouvez choisir de générer une à six images.negative_prompt string (Facultatif)Une invite négative décrivant le contenu à exclure de la sortie. Utilisez-la pour contraindre la génération.Prend en charge le chinois et l'anglais. Maximum 500 caractères. Chaque caractère chinois, lettre, chiffre ou symbole compte pour un caractère. Les caractères excédentaires sont automatiquement tronqués.Par exemple : faible résolution, erreur, meilleure qualité, basse qualité, défiguré, doigts supplémentaires ou mauvaises proportions.size string (Facultatif)La résolution de l'image de sortie au format width height. Exemple : "10241536".Modèles de la série qwen-image-2.0 :
Si vous spécifiez le paramètre
Résolutions recommandées pour les rapports d'aspect courants
bool (Facultatif)Active la réécriture intelligente des invites. Par défaut : true. Lorsqu'elle est activée, le modèle optimise l'invite positive (text), ce qui améliore considérablement les résultats pour les invites simples.Modèles pris en charge : Tous les modèles.watermark bool (Facultatif)Ajoute un filigrane « Qwen-Image » dans le coin inférieur droit. Par défaut : false.seed integer (Facultatif)La graine aléatoire. Plage valide : [0, 2147483647].Définir la même valeur de seed aide à maintenir une stabilité relative dans la sortie générée. 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 d'un appel à l'autre. |
Paramètres de la réponse |
Les données de la tâche (statut de la tâche et URL des images) ne sont conservées que pendant 24 heures, puis automatiquement purgées. Enregistrez rapidement les images générées. |
output objectLes résultats de génération du modèle.
Propriété choices arrayUne liste de choix de résultats.
Propriété finish_reason stringLa raison de l'arrêt de la tâche. Renvoie stop pour un arrêt naturel.message objectLe message renvoyé par le modèle.
Propriété role stringLe rôle du message. Fixé à assistant.contentarrayLe contenu du message contient les informations de l'image générée.
Propriété image stringURL de l'image générée au format PNG. Valable pendant 24 heures. Téléchargez et enregistrez l'image rapidement. | |
usage objectUtilisation des ressources pour cet appel. Renvoyé uniquement en cas de succès.
Propriété image_count integerLe nombre d'images générées.width integerLa largeur de l'image générée en pixels.height integerLa hauteur de l'image générée en pixels. | |
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. |
Appel via le SDK DashScope
Les noms des paramètres du SDK sont globalement cohérents avec ceux de l'API HTTP. La structure des paramètres est encapsulée selon les spécificités du langage. Pour une liste complète des paramètres, consultez la Référence de l'API Qwen.
Appel via le SDK Python
- Nous recommandons d'installer la dernière version du SDK Python DashScope pour éviter d'éventuelles erreurs d'exécution. Pour plus d'informations, consultez Installer ou mettre à niveau le SDK.
- Les interfaces asynchrones ne sont pas prises en charge.
Exemples de requête
Exemple de réponse
L'URL de l'image est valable pendant 24 heures. Téléchargez l'image rapidement.
Les champsinput_tokens,output_tokensetcharacterssont compatibles. Leurs valeurs sont actuellement fixées à 0.
Appel via le SDK Java
Installez la dernière version du SDK Java DashScope pour éviter les erreurs d'exécution. Consultez Installer ou mettre à niveau le SDK.
Exemples de requête
Exemples de réponse
L'URL de l'image est valable 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 les Codes d'erreur pour résoudre le problème.
Facturation et limitation de débit
- Pour les quotas gratuits et les tarifs de facturation des modèles, consultez la Liste des modèles.
- Reportez-vous à Qwen-Image pour les détails sur les limitations de débit du modèle.
- Facturation : Vous êtes facturé par image générée avec succès. Les appels échoués n'entraînent aucun frais et ne consomment pas votre quota gratuit nouvel utilisateur.




