Skip to main content

Qwen-Image Edit API reference

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)

image99

image98

image89

image100

imageout2

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èleDescription du modèleSpé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 :
  • Personnalisable : Le nombre total de pixels doit être compris entre 512512 et 20482048.
  • Par défaut : Le nombre total de pixels avoisine 1024*1024, avec un rapport d'aspect similaire à celui de l'image d'entrée (ou de la dernière image en cas d'entrée multi-images).
Format de l'image : pngNombre d'images : 1–6
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.
Les régions Chine (Pékin) et Singapour disposent de clés API et d'endpoints de requête distincts. Elles ne sont pas interchangeables. Les appels interrégionaux entraînent des échecs d'authentification ou des erreurs de service.

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

  • Édition d'image unique
  • Fusion multi-images
Cet exemple utilise le modèle qwen-image-2.0-pro pour générer deux images.
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
        --header 'Content-Type: application/json' \
        --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
        --data '{
            "model": "qwen-image-2.0-pro",
            "input": {
                "messages": [
                    {
                        "role": "user",
                        "content": [
                            {
                                "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
                            },
                            {
                                "text": "Generate an image that matches the depth map, following this description: A red, dilapidated bicycle is parked on a muddy path, with a dense primeval forest in the background."
                            }
                        ]
                    }
                ]
            },
            "parameters": {
                "n": 2,
                "negative_prompt": " ",
                "prompt_extend": true,
                "watermark": false,
                "size": "1536*1024"
            }
        }'
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é

rolestring (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 :
  • Format de l'image : JPG, JPEG, PNG, BMP, TIFF, WEBP ou GIF.
    L'image de sortie est au format PNG. Pour les GIF animés, seule la première image est traitée.
  • Résolution de l'image : Pour obtenir des résultats optimaux, la largeur et la hauteur de l'image doivent toutes deux être comprises entre 384 et 3072 pixels. Une faible résolution peut entraîner une sortie floue, tandis qu'une haute résolution augmente le temps de traitement.
  • Taille de l'image : 10 Mo maximum.
Formats d'entrée pris en charge
  1. URL publique :
    • Prend en charge les protocoles HTTP et HTTPS.
    • Par exemple : https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp.
  2. Chaîne d'image encodée en Base64
textstring(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 :
  • Le nombre total de pixels doit être compris entre 512512 et 20482048.
  • Par défaut, le nombre total de pixels avoisine 1024*1024, avec un rapport d'aspect similaire à celui de l'image d'entrée (ou de la dernière image en cas d'entrée multi-images).
Si vous spécifiez le paramètre size, le système utilise la largeur et la hauteur spécifiées par size comme cible et ajuste les dimensions de l'image de sortie réelle aux multiples de 16 les plus proches. Par exemple, si vous spécifiez 1033*1032, la taille de l'image de sortie sera 1040*1024.

Résolutions recommandées pour les rapports d'aspect courants

  • 1:1 : 10241024 ou 15361536
  • 2:3 : 7681152 ou 10241536
  • 3:2 : 1152768 ou 15361024
  • 3:4 : 9601280 ou 10801440
  • 4:3 : 1280960 ou 14401080
  • 9:16 : 7201280 ou 10801920
  • 16:9 : 1280720 ou 19201080
  • 21:9 : 1344576 ou 2048872
Modèles pris en charge : Tous les modèles.prompt_extend 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

  • Tâche réussie
  • Erreur de tâche
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": {
                "choices": [
                    {
                        "finish_reason": "stop",
                        "message": {
                            "role": "assistant",
                            "content": [
                                {
                                    "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                                },
                                {
                                    "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                                }
                            ]
                        }
                    }
                ]
            },
            "usage": {
                "width": 1536,
                "image_count": 2,
                "height": 1024
            },
            "request_id": "bf37ca26-0abe-98e4-8065-xxxxxx"
        }
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é

rolestringLe 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

import json
import os
import dashscope
from dashscope import MultiModalConversation

# The following is the URL for the Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. URLs vary by region.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# The model supports one to three input images.
messages = [
    {
        "role": "user",
        "content": [
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"},
            {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"},
            {"text": "The girl from Image 1 is wearing the black dress from Image 2 and sitting in the pose from Image 3."}
        ]
    }
]

# The API keys for the Singapore and Beijing regions are different. To get an API key, see https://www.alibabacloud.com/help/en/model-studio/get-api-key.
# If you have not configured the environment variable, replace the next line with: api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

# The qwen-image-2.0 series supports one to six output images. This example generates two.
response = MultiModalConversation.call(
    api_key=api_key,
    model="qwen-image-2.0-pro",
    messages=messages,
    stream=False,
    n=2,
    watermark=False,
    negative_prompt=" ",
    prompt_extend=True,
    size="1024*1536",
)

if response.status_code == 200:
    # To view the full response, uncomment the next line.
    # print(json.dumps(response, ensure_ascii=False))
    for i, content in enumerate(response.output.choices[0].message.content):
        print(f"URL of output image {i+1}: {content['image']}")
else:
    print(f"HTTP status code: {response.status_code}")
    print(f"Error code: {response.code}")
    print(f"Error message: {response.message}")
    print("For more information, see https://www.alibabacloud.com/help/en/model-studio/error-code")

Exemple de réponse

L'URL de l'image est valable pendant 24 heures. Téléchargez l'image rapidement.
Les champs input_tokens , output_tokens et characters sont compatibles. Leurs valeurs sont actuellement fixées à 0.
{
    "status_code": 200,
    "request_id": "fa41f9f9-3cb6-434d-a95d-4ae6b9xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/xxx.png?Expires=xxx"
                        },
                        {
                            "image": "https://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ],
        "audio": null
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "height": 1536,
        "image_count": 2,
        "width": 1024
    }
}

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

import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

import java.io.IOException;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.List;

public class QwenImageEdit {

    static {
        // The following is the URL for the Singapore region. Replace {WorkspaceId} with your Bailian workspace ID. URLs vary by region.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // The API keys for the Singapore and Beijing regions are different. To obtain an API key, see https://www.alibabacloud.com/help/en/model-studio/get-api-key.
    // If you have not configured the environment variable, replace the following line with your DashScope API key: apiKey="sk-xxx".
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void call() throws ApiException, NoApiKeyException, UploadFileException, IOException {

        MultiModalConversation conv = new MultiModalConversation();

        // The model supports one to three input images.
        MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/thtclx/input1.png"),
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/iclsnx/input2.png"),
                        Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/gborgw/input3.png"),
                        Collections.singletonMap("text", "The girl from Image 1 is wearing the black dress from Image 2 and sitting in the pose from Image 3.")
                )).build();
        // The qwen-image-2.0 series models support one to six output images. This example generates two images.
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("watermark", false);
        parameters.put("negative_prompt", " ");
        parameters.put("n", 2);
        parameters.put("prompt_extend", true);
        parameters.put("size", "1024*1536");

        MultiModalConversationParam param = MultiModalConversationParam.builder()
                .apiKey(apiKey)
                .model("qwen-image-2.0-pro")
                .messages(Collections.singletonList(userMessage))
                .parameters(parameters)
                .build();

        MultiModalConversationResult result = conv.call(param);
        // To view the complete response, uncomment the following line.
        // System.out.println(JsonUtils.toJson(result));
        List<Map<String, Object>> contentList = result.getOutput().getChoices().get(0).getMessage().getContent();
        int imageIndex = 1;
        for (Map<String, Object> content : contentList) {
            if (content.containsKey("image")) {
                System.out.println("URL of output image " + imageIndex + ": " + content.get("image"));
                imageIndex++;
            }
        }
    }

    public static void main(String[] args) {
        try {
            call();
        } catch (ApiException | NoApiKeyException | UploadFileException | IOException e) {
            System.out.println(e.getMessage());
        }
    }
}

Exemples de réponse

L'URL de l'image est valable pendant 24 heures. Téléchargez l'image rapidement.
{
    "requestId": "46281da9-9e02-941c-ac78-be88b8xxxxxx",
    "usage": {
        "image_count": 2,
        "width": 1024,
        "height": 1536
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        },
                        {
                            "image": "https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png?Expires=xxx"
                        }
                    ]
                }
            }
        ]
    }
}

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.

FAQ

Q : Quelles langues le modèle d'édition d'images Qwen prend-il en charge ?

R : Le modèle prend actuellement en charge le chinois simplifié et l'anglais. Vous pouvez essayer d'autres langues, mais les performances ne sont pas garanties.

Q : Comment consulter les métriques d'invocation du modèle ?

R : Une heure après la fin d'une invocation de modèle, accédez à la page Monitoring (Singapore) ou Monitoring (China (Beijing)) pour consulter des métriques telles que le nombre d'invocations et le taux de réussite. Pour plus d'informations, consultez Facturation et gestion des coûts.

Q : Comment obtenir la liste d'autorisation de noms de domaine pour le stockage d'images ?

R : Les images générées par les modèles sont stockées dans OSS. L'API renvoie une URL publique temporaire. Pour configurer une liste d'autorisation de pare-feu pour cette URL de téléchargement, notez ce qui suit : Le stockage sous-jacent peut changer dynamiquement. Cette rubrique ne fournit pas de liste d'autorisation de noms de domaine OSS fixe afin d'éviter les problèmes d'accès causés par des informations obsolètes. Si vous avez des exigences en matière de contrôle de sécurité, contactez votre gestionnaire de compte pour obtenir la dernière liste de noms de domaine OSS.