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.
qwen/qwen-image-3.0-proHaut de gammeqwen/qwen-image-3.0StandardPour les prix en vigueur, consultez la page du modèle .
Différences avec les autres familles
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
Python
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
n vaut 6 au maximum.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
input_images, 3 au maximum ; le champ image n’est pas utilisé et /v1/images/edits n’est pas pris en charge.Python
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_imagesest un tableau dont chaque élément est une URL d’image ou une chaîne commençant pardata:image/...;base64,, de 1 à 3 images ; au-delà de 3, renvoie 400.imageest un champ propre à Seedream, non pris en charge par Qwen-Image.- Sans
sizelors 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
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.