Skip to Content
ModèlesQwen-Image

Famille Qwen-Image

Les modèles d’images Tongyi d’Alibaba, au nombre de deux. Ils s’appellent via l’endpoint compatible OpenAI /v1/images/generations, qui sert aussi bien au texte vers image qu’à l’édition.

Choix du modèle

Les deux modèles ont exactement les mêmes paramètres. Pro est la version haut de gamme, meilleure pour le rendu du texte et la qualité de l’image.

ID de modèle (à copier tel quel)
Qwen-Image 3.0 Proqwen/qwen-image-3.0-proHaut de gamme
Qwen-Image 3.0qwen/qwen-image-3.0Standard

Pour les prix en vigueur, consultez la page du modèle .

Différences avec les autres familles

L'essentielLa réponse contient un lien vers l’image et non du base64 ; le lien expire au bout de 24 heures.
Qwen-ImageGPT Image, Seedream, etc.
Réponsedata[].url, lien temporaire Alibaba Cloud OSSdata[].b64_json
Champ des images de référenceinput_imagesimage pour Seedream
/v1/images/editsNon pris en chargePris en charge par GPT Image

Durée de validité du lien : le paramètre Expires du lien correspond à 24 heures après la génération. Pour une utilisation durable, téléchargez l’image et stockez-la rapidement ; n’enregistrez pas le lien tel quel dans une base de données.

Texte vers image

qwen_image.py
import urllib.request from openai import OpenAI client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600) resp = client.images.generate( model="qwen/qwen-image-3.0-pro", prompt="Une pomme rouge sur une table blanche, avec à côté une carte portant le mot « OfoxAI »", size="1024x1024", ) # La réponse est un lien temporaire : téléchargez l'image dans les 24 heures urllib.request.urlretrieve(resp.data[0].url, "output.png")

Taille et nombre d’images

L'essentielLe nombre total de pixels doit être compris entre 512×512 et 2560×2560 ; n vaut 6 au maximum.
ParamètreValeursRemarques
sizeLARGEURxHAUTEURDe 262 144 (512×512) à 6 553 600 (2560×2560) pixels au total ; hors de cette plage, renvoie 400
size omis—Sortie de 2048×2048 mesurée
n1–6Plusieurs liens renvoyés en un appel ; 7 ou plus renvoie 400

Nous avons vérifié que 2560x1440 fonctionne. Côté latence : environ 10 à 60 secondes en 1024×1024, environ 60 secondes en 2560×1440, et environ 50 à 100 secondes pour une édition. Nous recommandons un délai d’attente client de 300 secondes ou plus.

Édition et références multiples

L'essentielLes images de référence passent par input_images, 3 au maximum ; le champ image n’est pas utilisé et /v1/images/edits n’est pas pris en charge.
qwen_edit.py
import base64 import urllib.request from openai import OpenAI client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.ai/v1", timeout=600) with open("apple.jpg", "rb") as f: ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode() resp = client.images.generate( model="qwen/qwen-image-3.0-pro", prompt="Rends la pomme violette et laisse le reste intact", extra_body={"input_images": [ref]}, ) urllib.request.urlretrieve(resp.data[0].url, "apple_purple.png")
  • input_images est un tableau dont chaque élément est une URL d’image ou une chaîne commençant par data:image/...;base64,, de 1 à 3 images ; au-delà de 3, renvoie 400.
  • image est un champ propre à Seedream, non pris en charge par Qwen-Image.
  • Sans size lors d’une édition, nous avons mesuré une sortie de 2048×2048, qui peut différer de l’image d’origine. Pour conserver la taille, indiquez-la explicitement.

Autres paramètres

D’après nos tests, negative_prompt (ce que l’on ne veut pas voir apparaître) et prompt_extend (enrichissement automatique de la consigne par le modèle) sont acceptés normalement. Définition des paramètres : documentation officielle d’Alibaba Cloud Model Studio .

Erreurs courantes

Message d’erreur (extrait)CauseSolution
Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requestsTaille trop petite ou trop grandeRamenez-la dans la plage, p. ex. 1024x1024 ou 2560x1440
Input should be less than or equal to 6: parameters.nn supérieur à 6Ramenez-le à 6 ou moins ; pour davantage d’images, répartissez sur plusieurs requêtes
supports 0~3 image content items. Got 4 image items.Plus de 3 images de référenceRéduisez à 3 ou moins
does not support the /v1/images/edits endpointAppel de l’endpoint d’éditionUtilisez input_images sur /v1/images/generations
Image de référence sans effetUtilisation du champ imageUtilisez input_images
Lien de l’image inaccessibleLe lien a dépassé sa validité de 24 heuresRégénérez l’image ; téléchargez et stockez-la dès réception du lien

Le nom qwen-image-3.0-distill présent dans le message d’erreur est un nom de modèle interne en amont ; pour vos appels, utilisez toujours les ID de modèle listés sur cette page.

Messages d’erreur exacts

Image area must be between 262144 (512x512) and 6553600 (2560x2560) pixels for t2i requests. Got area=10000 (width=100, height=100). Input should be less than or equal to 6: parameters.n Model 'qwen-image-3.0-distill' supports 0~3 image content items. Got 4 image items. (0 images = T2I mode, 1~3 images = I2I mode)

FAQ

Pourquoi Qwen-Image renvoie-t-il url et non b64_json ?

Qwen-Image renvoie un lien d'image temporaire Alibaba Cloud OSS (data[].url), et non du base64. Le lien expire au bout de 24 heures : téléchargez l'image et stockez-la au plus vite.

Comment éditer une image avec Qwen-Image ?

Passez input_images dans /v1/images/generations (un tableau de 1 à 3 images, chaque élément étant une URL d'image ou un base64 commençant par data:image). image est le champ de Seedream, non pris en charge par Qwen-Image ; /v1/images/edits ne l'est pas non plus.

Qwen-Image renvoie Image area must be between 262144 and 6553600 pixels ?

Le nombre total de pixels doit être compris entre 512x512 et 2560x2560. Par exemple, 100x100 est trop petit et 3000x3000 trop grand. Passez à 1024x1024, 2048x2048, 2560x1440, etc.

Combien d'images Qwen-Image peut-il générer au maximum en une fois ?

n vaut 6 au maximum ; 7 ou plus renvoie 400. Pour davantage d'images, répartissez sur plusieurs requêtes.

Le lien d'image de Qwen-Image ne s'ouvre plus ?

Le paramètre Expires du lien correspond à 24 heures après la génération ; une fois expiré, l'image ne peut plus être téléchargée et doit être régénérée. Dès réception du lien, téléchargez l'image et enregistrez-la sur votre propre stockage.

Dernière mise à jour le