Familia Qwen-Image
Los modelos de imagen Tongyi de Alibaba, dos en total. Se llaman a través del endpoint compatible con OpenAI /v1/images/generations, que se usa tanto para texto a imagen como para edición.
Elección de modelo
Los dos tienen exactamente los mismos parámetros. Pro es la versión superior, con mejor renderizado de texto y mejor acabado visual.
qwen/qwen-image-3.0-proGama altaqwen/qwen-image-3.0Gama estándarPara los precios vigentes, consulte la página del modelo .
Diferencias con otras familias
Validez del enlace: el parámetro Expires del enlace corresponde a 24 horas después de la generación. Si necesita conservar la imagen, descárguela y guárdela a tiempo; no guarde el enlace directamente en la base de datos.
Texto a imagen
Python
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
resp = client.images.generate(
model="qwen/qwen-image-3.0-pro",
prompt="Una manzana roja sobre una mesa blanca, junto a una tarjeta que dice «OfoxAI»",
size="1024x1024",
)
# Se devuelve un enlace temporal: descárguelo en menos de 24 horas
urllib.request.urlretrieve(resp.data[0].url, "output.png")Tamaño y número de imágenes
n es 6.En nuestras mediciones, 2560x1440 funciona. En cuanto a la latencia, 1024×1024 tarda entre 10 y 60 segundos, 2560×1440 unos 60 segundos y la edición entre 50 y 100 segundos. Se recomienda configurar el tiempo de espera del cliente en 300 segundos o más.
Edición y referencia de varias imágenes
input_images, hasta 3; no se usa el campo image ni se admite /v1/images/edits.Python
import base64
import urllib.request
from openai import OpenAI
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/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="Cambia la manzana a color morado y deja todo lo demás igual",
extra_body={"input_images": [ref]},
)
urllib.request.urlretrieve(resp.data[0].url, "apple_purple.png")input_imageses un array; cada elemento es una URL de imagen o una cadena que empieza pordata:image/...;base64,. Admite de 1 a 3 imágenes; con más de 3 devuelve 400.imagees un campo exclusivo de Seedream; Qwen-Image no lo admite.- Si al editar no se envía
size, en nuestras mediciones la salida es de 2048×2048, que puede no coincidir con la imagen original. Para conservar el tamaño, indíquelo explícitamente.
Otros parámetros
En nuestras mediciones, negative_prompt (lo que no se desea que aparezca) y prompt_extend (si el modelo amplía automáticamente el prompt) se pueden enviar sin problemas. La definición de los parámetros está en la documentación oficial de Alibaba Cloud Model Studio .
Errores habituales
El qwen-image-3.0-distill que aparece en el mensaje de error es el nombre interno del modelo en el proveedor de origen; al llamar, siga usando los ID de modelo de esta página.
Mensajes de error originales
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)Preguntas frecuentes
¿Por qué Qwen-Image devuelve url en lugar de b64_json?
Qwen-Image devuelve un enlace temporal a la imagen en Alibaba Cloud OSS (data[].url), no base64. El enlace caduca a las 24 horas; descargue y guarde la imagen en cuanto lo obtenga.
¿Cómo se edita con Qwen-Image?
Envíe input_images en /v1/images/generations (un array de 1 a 3 imágenes; cada elemento es una URL de imagen o un base64 que empieza por data:image). image es un campo de Seedream que Qwen-Image no admite; tampoco se admite /v1/images/edits.
¿Por qué Qwen-Image devuelve Image area must be between 262144 and 6553600 pixels?
El total de píxeles del tamaño debe estar entre 512x512 y 2560x2560. Por ejemplo, 100x100 es demasiado pequeño y 3000x3000 demasiado grande. Use 1024x1024, 2048x2048, 2560x1440 u otro similar.
¿Cuántas imágenes puede generar Qwen-Image como máximo en una petición?
n admite como máximo 6; con 7 o más devuelve 400. Si necesita más, haga varias peticiones.
¿Por qué ya no se abre el enlace de la imagen de Qwen-Image?
El parámetro Expires del enlace corresponde a 24 horas después de la generación; una vez caducado, no se puede descargar y solo queda volver a generar la imagen. Descargue la imagen en cuanto obtenga el enlace y guárdela en su propio almacenamiento.