Comment utiliser l’API Qwen Image 3.0 : génération, édition et tarification

TL;DR

Qwen Image 3.0 unifie la génération d’images à partir de texte et l’édition guidée par des références sous les variantes Standard (qwen-image-3.0) et Pro (qwen-image-3.0-pro). Commencez par une invite textuelle, choisissez une taille de sortie, soumettez une requête de génération d’images et enregistrez rapidement la sortie. Pour l’édition, joignez une à trois images de référence et une instruction explicite de préservation. Sur CometAPI, vérifiez la route effective et le schéma de requête compatible avant de déployer les appels d’exemple.

Points clés à retenir

• L’API Qwen Image 3.0 prend en charge la génération d’images à partir de texte et l’édition guidée par des références via les variantes Standard (qwen-image-3.0) et Pro (qwen-image-3.0-pro) ; le format de sortie natif est PNG.
• L’accès à l’API Qwen Image 3.0 est disponible via CometAPI. Les développeurs peuvent obtenir une clé d’API, vérifier le point de terminaison pris en charge et intégrer la génération d’images dans leurs applications.
• La tarification de l’API Qwen Image 3.0 commence à $0.024/requête sur CometAPI, contre des tarifs Alibaba Cloud Singapour à partir de $0.030 par image de sortie Standard et $0.040 par image de sortie Pro 1K.
• L’édition d’images Qwen Image 3.0 prend en charge jusqu’à trois images de référence via l’API native Alibaba Cloud, tandis que la génération prend en charge de une à six sorties par requête.
• L’intégration de l’API Qwen Image 3.0 exige que les développeurs valident les paramètres spécifiques au fournisseur, l’authentification, les unités de facturation et les URL d’images temporaires avant de déployer des workflows de production.

Qu’est-ce que l’API Qwen Image 3.0 ?

L’API Qwen Image 3.0 transforme des instructions textuelles en images et peut modifier des photographies ou des ressources de design fournies. Les scénarios pris en charge incluent les affiches multilingues, la photographie e-commerce, les maquettes de campagne, le remplacement d’arrière-plan et l’édition d’images composites.

Qwen Image 3.0 Standard (qwen-image-3.0) est la base axée sur les coûts pour la génération d’images à partir de texte et l’édition guidée par des références. Privilégiez-la pour des flux à grand volume comme des variations d’arrière-plan pour l’e-commerce, des brouillons visuels pour les réseaux sociaux et l’exploration de concepts de campagne. Par exemple, utilisez Standard pour produire plusieurs options d’arrière-plan produit, puis évaluez la fidélité du produit et sélectionnez les versions à affiner.

Qwen Image 3.0 Pro (qwen-image-3.0-pro) prend en charge la génération et l’édition guidée par des références, avec un palier de sortie 2K natif plus onéreux. Évaluez-le pour des livrables sensibles à la qualité comme des images phares de campagne, des compositions produit détaillées et des affiches promotionnelles. Par exemple, testez un concept présélectionné avec Pro lorsque les détails fins ou la mise en page comptent, et comparez les résultats retenus avec Standard avant d’engager un budget plus important.

Comment choisir : Commencez avec Standard pour des brouillons et des variations sensibles au coût. Testez Pro sur le même brief pour des actifs finaux exigeants ; sélectionnez-le lorsque l’amélioration mesurée justifie le surcoût. Aucune désignation ne remplace des tests spécifiques à l’application pour la typographie, la fidélité produit, le comptage des objets ou la précision de la mise en page.

Quels paramètres l’API Qwen Image 3.0 prend-elle en charge ?

Utilisez ces paramètres avec l’interface native d’Alibaba Cloud compatible avec OpenAI. Ajoutez des options spécifiques au fournisseur aux requêtes CometAPI uniquement lorsque la route choisie les documente.

S’applique aux deux variantes : qwen-image-3.0 (Standard) et qwen-image-3.0-pro (Pro) prennent en charge les mêmes paramètres listés ci-dessous sur l’interface native compatible OpenAI d’Alibaba Cloud. Sélectionnez la variante avec model ; les contrôles de génération et d’édition sont partagés. Cela n’implique pas une qualité de sortie ou une tarification identiques, ni ne garantit que chaque route CometAPI expose tous les paramètres natifs.

Pour les requêtes natives, le rapport d’aspect de sortie doit rester entre 1:8 et 8:1. Les images de référence doivent faire au plus 10 MB, avec chaque côté entre 1 et 8,000 pixels et un rapport longueur/largeur maximal de 10:1. Utilisez un URI de données pour l’entrée Base64. Thinking nécessite prompt_extend=true ; l’amélioration via agent ne prend en charge que le text-to-image.

Une requête d’image compatible place les champs de génération au niveau supérieur du JSON et formate les dimensions en 1024x1024. DashScope natif utilise des champs imbriqués input/parameters et écrit souvent les dimensions en 1024*1024. Une requête copiée entre ces points de terminaison sans conversion peut échouer.

Comment appeler l’API Qwen Image 3.0 avec CometAPI ?

Ce guide suppose Python 3, un terminal compatible Bash, un compte CometAPI avec accès au modèle et un solde suffisant. La première requête utilise uniquement les champs model et prompt affichés dans l’exemple du fournisseur. Documentation vérifiée le 16 octobre 2026 ; ces exemples n’ont pas été exécutés sur un compte payant.

Créer des informations d’identification

Créez une clé d’API côté serveur dans votre tableau de bord CometAPI. Ne l’intégrez jamais dans un client web ou mobile.

export COMETAPI_KEY="your_api_key"python -m pip install requests

Soumettre une requête minimale de génération

Les développeurs peuvent accéder à l’API Qwen Image 3.0 dans CometAPI via la route de génération d’images documentée. Commencez par la requête minimale ci-dessous avant d’introduire des paramètres optionnels.

curl --fail-with-body https://api.cometapi.com/v1/images/generations \  -H "Authorization: Bearer $COMETAPI_KEY" \  -H "Content-Type: application/json" \  -d '{"model":"qwen-image-3.0","prompt":"Premium skincare bottle on a stone pedestal, gentle studio lighting"}'

Enregistrer chaque image renvoyée

Enregistrez le script suivant sous generate.py et exécutez python generate.py. Il soumet une requête, gère des résultats d’images par URL ou Base64, et écrit chaque image localement. Si la réponse contient des informations de tâche au lieu d’un tableau data, il s’arrête plutôt que de deviner un point de terminaison de polling ; utilisez le contrat asynchrone spécifique au compte pour récupérer le résultat terminé.

import base64import osfrom pathlib import Pathimport requests​response = requests.post(    "https://api.cometapi.com/v1/images/generations",    headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"},    json={"model": "qwen-image-3.0", "prompt": "A sunny bookstore cafe, editorial photograph"},    timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images:    raise RuntimeError(f"No synchronous images; inspect task/error fields: {list(result)}")for index, item in enumerate(images, 1):    if item.get("url"):        download = requests.get(item["url"], timeout=(15, 120))        download.raise_for_status()        content = download.content    elif item.get("b64_json"):        content = base64.b64decode(item["b64_json"], validate=True)    else:        raise RuntimeError(f"Image {index} has no URL or Base64 payload")    path = Path(f"qwen_image_{index}.png")    path.write_bytes(content)    print(f"Saved {path}")

Une exécution réussie produit des fichiers image locaux. Ouvrez-les pour confirmer qu’ils sont lisibles et correspondent à la scène demandée. Conservez l’identifiant de requête et les champs d’usage dans vos journaux serveur sans consigner les identifiants.

Comment générer plusieurs images avec Qwen Image 3.0 ?

Sur l’interface native d’Alibaba Cloud, définissez n entre deux et six pour des variations créatives. Pour CometAPI, activez n uniquement après avoir confirmé sa prise en charge sur la route sélectionnée. Validez chaque ressource renvoyée séparément ; un n plus élevé ne garantit pas que chaque résultat réussira les validations en aval.

Vous pouvez générer jusqu’à 6 images dans une seule requête avec Qwen Image 3.0 en définissant le paramètre n. Ceci fonctionne avec qwen-image-3.0 et qwen-image-3.0-pro, pour la génération à partir de texte et l’édition d’images. La valeur par défaut est une seule image.

Il existe deux principales façons de procéder : utiliser une interface graphique si votre plateforme expose l’option, ou appeler l’API directement.

Générer plusieurs images via l’API

1. Ouvrez la documentation de l’API.
2. Obtenez une clé d’API depuis la console QwenCloud / CometAPI.
3. Sélectionnez qwen-image-3.0 ou qwen-image-3.0-pro.
4. Définissez n sur le nombre d’images souhaitées, de 1 à 6.
5. Soumettez votre invite et enregistrez les images renvoyées.

Par exemple, définissez "n": 4 pour demander quatre variations de la même invite.

Exemple Python

Voici un exemple prêt à l’emploi utilisant l’API compatible OpenAI.

from openai import OpenAIimport requestsclient = OpenAI(    api_key="YOUR_QWEN_API_KEY",    base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate(    model="qwen-image-3.0-pro",    
prompt=(        "A cozy Japanese cafe on a rainy evening, "        "warm glowing lights, cinematic photography, "        "rich details, realistic reflections"    ),    
n=4,    
size="1024x1024")# Save each generated image
for i, item in enumerate(result.data, start=1):    response = requests.get(item.url)    response.raise_for_status()    with open(f"qwen_image_{i}.png", "wb") 
as f:        
f.write(response.content)print("Finished generating images!")

Installez d’abord les packages requis :

pip install openai requests

L’API renvoie une URL d’image pour chaque résultat. Les URL d’images générées sont temporaires, téléchargez donc les images rapidement.

Paramètres importants

Le nombre maximal de sorties est de six par requête. Gardez à l’esprit que demander plus d’images augmente le coût de génération.

Une distinction importante : n=4 demande quatre variations d’une même invite. Si vous souhaitez quatre invites différentes, vous devez faire des requêtes séparées ou automatiser une boucle sur vos invites.

Comment éditer des images avec Qwen Image 3.0 ?

Une édition combine une à trois images de référence avec des instructions. Expliquez à la fois la transformation souhaitée et ce qui ne doit pas changer — par exemple l’étiquette du produit, la couleur, l’angle de caméra ou la géométrie de l’emballage.

L’exemple suivant utilise des identifiants Alibaba Cloud et son champ d’image JSON pour l’édition. Créez une clé Model Studio régionale, obtenez votre ID d’espace de travail et configurez le point de terminaison correspondant. N’insérez pas une clé CometAPI dans cette requête.

export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"

L’image de référence ci-dessous provient directement de l’exemple officiel de l’API. Il s’agit d’une image d’entrée, et non d’un résultat généré par cet article.

import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]  
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0", 
"prompt": "Change the outfit to a charcoal business suit in a cafe. Preserve the face and hairstyle.", 
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"], 
"size": "1024x1024", 
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())

Le point de terminaison compatible natif utilise du JSON sur /images/generations, et non des envois multipart sur /images/edits. Il ne prend pas en charge les masques ni le streaming. Lisez le tableau data renvoyé et enregistrez chaque URL en utilisant la même boucle de téléchargement présentée ci-dessus.

Pour deux références, incluez deux URL dans le tableau image et précisez leurs rôles dans l’invite (par ex., produit de la première image, décor de la deuxième). La série Qwen Image 3.0 n’accepte pas plus de trois images de référence ; utilisez un autre modèle ou un workflow de prétraitement pour des ensembles sources plus volumineux.

Combien coûte l’API Qwen Image 3.0 ?

La tarification de l’API Qwen Image 3.0 varie selon la variante du modèle, la résolution de sortie et le fournisseur. Le tableau ci-dessous complète la comparaison initiale d’Alibaba Cloud Singapour avec les tarifs CometAPI figurant dans le tableau de prix fourni par le réviseur. La pièce jointe liste les prix de sortie en USD par image et une réduction de 20 % pour les quatre combinaisons modèle/résolution. Ces tarifs fournis n’ont pas été revérifiés de manière indépendante par rapport à la facturation d’un compte en direct ; confirmez la grille tarifaire applicable avant l’usage en production.

*Les exemples de volume ci-dessus couvrent uniquement les images de sortie : 100 images Standard 1K coûtent $2.40 et 100 images Pro 1K coûtent $3.20 ; 1,000 images Standard 2K coûtent $24.00 et 1,000 images Pro 2K coûtent $60.00. Pour l’édition, ajoutez $0.0024 par image de référence d’entrée facturable. Les règles pour les jobs échoués, les taxes et les ajustements spécifiques au compte sont exclus.

En utilisant les tarifs fournis pour les images d’entrée et de sortie, estimez les frais d’images pour l’un ou l’autre fournisseur comme suit :

Coût total = (images de référence facturables × prix par image d’entrée) + (sorties réussies × prix par image de sortie).

Pour un job facturé pour deux images de référence en entrée et trois sorties Standard 1K réussies, les frais d’images Alibaba Cloud sont (2 × $0.0030) + (3 × $0.0300) = $0.0960. Les frais d’images CometAPI correspondants sont (2 × $0.0024) + (3 × $0.0240) = $0.0768, sur la base des tarifs fournis.

CometAPI facture $0.0024 par image de référence en entrée pour les deux variantes. Les prix de sortie sont $0.0240 par image Standard en 1K ou 2K, $0.0320 par image Pro en 1K, et $0.0600 par image Pro en 2K. Le tableau fourni liste chaque tarif d’entrée et de sortie à 20 % en dessous de son prix officiel correspondant. Pour les mêmes volumes d’images facturables, ces frais d’images sont donc inférieurs de 20 % ; des frais supplémentaires ou des conditions de compte peuvent modifier la facture finale.

Pour la budgétisation de production, vérifiez la variante sélectionnée, la résolution d’image, les frais pour images de référence, le nombre de sorties par requête et les remises de compte applicables avant d’estimer le coût total d’usage.

Comment gérer les erreurs de l’API Qwen Image 3.0 ?

FAQ

Dois-je réessayer une requête Qwen Image 3.0 après un timeout ?

Un timeout côté client ne prouve pas que la génération s’est arrêtée. Conservez tout identifiant de requête ou de tâche, consultez l’historique des jobs du fournisseur ou l’API de statut documentée, et déterminez si une sortie existe déjà avant de soumettre à nouveau. Les réessais à l’aveugle peuvent créer des jobs en double et des frais supplémentaires. Utilisez des réessais bornés pour les défaillances transitoires et suivez les conseils d’idempotence du fournisseur lorsqu’ils existent.

Comment utiliser des images de référence locales avec Qwen Image 3.0 ?

Pour l’interface compatible native, lisez le fichier en octets, encodez-le en Base64 et préfixez un URI de données tel que data:image/png;base64,. Placez cette chaîne complète dans image. L’entrée Base64 doit toujours respecter les limites de taille et de dimensions de l’image ; un chemin de fichier local n’est pas une URL que le service peut récupérer.

Comment transmettre des options spécifiques à Qwen via un SDK OpenAI ?

Conservez les champs d’image standard dans leurs arguments SDK habituels et placez les champs d’extension Model Studio, tels que image et prompt_extend, dans extra_body. Les requêtes HTTP brutes placent ces champs directement au niveau supérieur du JSON. Cette recommandation s’applique à l’interface compatible native ; vérifiez la route CometAPI sélectionnée avant de relayer des options spécifiques au fournisseur.

Que faire lorsque Qwen Image 3.0 renvoie moins d’images que demandé ?

Enregistrez d’abord les sorties réussies et consignez le nombre réel. Pour la facturation native Alibaba Cloud, les frais de sortie suivent les images générées avec succès. Si des ressources supplémentaires sont nécessaires, ne demandez que la quantité manquante après vérification de la réponse et de l’enregistrement d’usage ; la facturation CometAPI doit être rapprochée selon ses propres conditions de compte.

Conclusion

Qwen Image 3.0 est un choix pratique pour les équipes qui ont besoin de génération et d’édits pilotés par des références au sein d’une même famille de modèles. Utilisez Standard comme base économiquement optimisée, testez Pro pour des tâches 2K ou créatives plus exigeantes, et mesurez le coût par sortie acceptée plutôt que de juger au prix par requête. Commencez par l’appel minimal de génération, conservez ses sorties, puis ajoutez l’édition ou des sorties multiples via le contrat fournisseur approprié. Séparez les identifiants et schémas de requête, gérez explicitement les erreurs et rapprochez l’usage des images avec la grille tarifaire sélectionnée.