Cómo usar la API de Qwen Image 3.0: generación, edición y precios

TL;DR

Qwen Image 3.0 unifica la generación de texto a imagen y la edición guiada por referencias en las variantes Standard (qwen-image-3.0) y Pro (qwen-image-3.0-pro). Comienza con un prompt de texto, elige un tamaño de salida, envía una solicitud de generación de imagen y guarda el resultado de inmediato. Para edición, incluye de una a tres imágenes de referencia y una instrucción explícita de preservación. En CometAPI, verifica la ruta real y el esquema de solicitud compatible antes de implementar las llamadas de ejemplo.

Key Takeaways

• La API de Qwen Image 3.0 admite generación de texto a imagen y edición guiada por referencias mediante Standard (qwen-image-3.0) y Pro (qwen-image-3.0-pro); el formato nativo es PNG.
• El acceso a la API de Qwen Image 3.0 está disponible a través de CometAPI. Los desarrolladores pueden obtener una clave de API, verificar el endpoint compatible e integrar la generación de imágenes en sus aplicaciones.
• Los precios de la API de Qwen Image 3.0 comienzan en $0.024/solicitud en CometAPI, en comparación con las tarifas de Alibaba Cloud Singapur desde $0.030 por imagen de salida Standard y $0.040 por imagen de salida Pro 1K.
• La edición de imágenes con Qwen Image 3.0 admite hasta tres imágenes de referencia mediante la API nativa de Alibaba Cloud, mientras que la generación admite de una a seis salidas por solicitud.
• La integración de la API de Qwen Image 3.0 requiere que los desarrolladores verifiquen parámetros específicos del proveedor, autenticación, unidades de facturación y URLs temporales de imágenes antes de implementar flujos de trabajo de producción.

What Is the Qwen Image 3.0 API?

La API de Qwen Image 3.0 convierte instrucciones de texto en imágenes y puede transformar fotografías o activos de diseño proporcionados. Los escenarios compatibles incluyen carteles multilingües, fotografía de e‑commerce, maquetas de campañas, reemplazo de fondo y edición de imágenes compuestas.

Qwen Image 3.0 Standard (qwen-image-3.0) es la base centrada en costos para generación de texto a imagen y edición guiada por referencias. Considérala primero para flujos de alto volumen como variaciones de fondos en e‑commerce, borradores visuales para redes sociales y exploración de conceptos de campañas. Por ejemplo, usa Standard para producir varias opciones de fondo de producto, luego revisa la fidelidad del producto y selecciona las versiones que vale la pena refinar.

Qwen Image 3.0 Pro (qwen-image-3.0-pro) admite generación y edición guiada por referencias, con un nivel nativo de salida 2K de mayor precio. Evalúalo para entregables sensibles a la calidad, como imágenes principales de campaña, composiciones detalladas de producto y carteles promocionales. Por ejemplo, prueba un concepto preseleccionado con Pro cuando los detalles finos o el layout importen, y compara los resultados aceptados con Standard antes de comprometer un presupuesto mayor.

Cómo elegir: Empieza con Standard para borradores y variaciones sensibles al costo. Prueba Pro con el mismo briefing para activos finales exigentes; selecciónalo cuando la mejora medida justifique el costo adicional. Ninguna designación sustituye las pruebas específicas de la aplicación sobre tipografía, fidelidad de producto, conteo de objetos o precisión de layout.

What Parameters Does Qwen Image 3.0 API Support?

Usa estos parámetros con la interfaz nativa compatible con OpenAI de Alibaba Cloud. Agrega opciones específicas del proveedor a las solicitudes de CometAPI solo cuando la ruta seleccionada las documente.

Aplica a ambas variantes: qwen-image-3.0 (Standard) y qwen-image-3.0-pro (Pro) admiten los mismos parámetros listados a continuación en la interfaz nativa compatible con OpenAI de Alibaba Cloud. Selecciona la variante con model; los controles de generación y edición son compartidos. Esto no implica calidad de salida o precios idénticos, ni garantiza que todas las rutas de CometAPI expongan todos los parámetros nativos.

Para solicitudes nativas, la relación de aspecto de salida debe mantenerse entre 1:8 y 8:1. Las imágenes de referencia deben ser de como máximo 10 MB, con cada lado entre 1 y 8,000 píxeles y una relación entre lado más largo y más corto no mayor a 10:1. Usa un data URI para entrada Base64. Thinking requiere prompt_extend=true; la mejora agent admite solo texto a imagen.

Una solicitud compatible coloca los campos de generación en el nivel superior del JSON y formatea las dimensiones como 1024x1024. DashScope nativo utiliza input/parameters anidados y suele escribir dimensiones como 1024*1024. Una solicitud copiada entre estos endpoints sin conversión puede fallar.

How Do You Call Qwen Image 3.0 API with CometAPI?

Este recorrido asume Python 3, una terminal compatible con Bash, una cuenta de CometAPI con acceso al modelo y saldo suficiente. La primera solicitud usa solo los campos model y prompt mostrados en el ejemplo del proveedor. Documentación verificada el 16 de octubre de 2026; estos ejemplos no se han ejecutado contra una cuenta de pago.

Create credentials

Crea una clave de API del lado servidor en tu panel de CometAPI. Nunca la incluyas en un cliente web o móvil.

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

Submit a minimal generation request

Los desarrolladores pueden acceder a la API de Qwen Image 3.0 en CometAPI usando la ruta documentada de generación de imágenes. Comienza con la solicitud mínima siguiente antes de introducir parámetros opcionales.

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"}'

Save every returned image

Guarda el siguiente script como generate.py y ejecuta python generate.py. Envía una solicitud, maneja resultados de imagen por URL o Base64, y escribe cada imagen localmente. Si la respuesta contiene información de tarea en lugar de un arreglo data, se detiene en vez de suponer un endpoint de sondeo; usa el contrato asincrónico específico de la cuenta para recuperar el resultado completo.

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}")

Una ejecución exitosa produce archivos de imagen locales. Ábrelos para confirmar que son legibles y coinciden con la escena solicitada. Conserva el identificador de la solicitud y los campos de uso en tus registros del servidor sin registrar credenciales.

How Do You Generate Multiple Images with Qwen Image 3.0?

En la interfaz nativa de Alibaba Cloud, establece n de dos a seis para variaciones creativas. En CometAPI, habilita n solo después de confirmar el soporte en tu ruta seleccionada. Valida cada recurso devuelto por separado; un n mayor no garantiza que cada resultado pase la revisión posterior.

Puedes generar hasta 6 imágenes en una sola solicitud con Qwen Image 3.0 estableciendo el parámetro n. Esto funciona con qwen-image-3.0 y qwen-image-3.0-pro, tanto para generación de texto a imagen como para edición de imagen. El valor predeterminado es una sola imagen.

Hay dos formas principales de hacerlo: usar una interfaz gráfica si tu plataforma expone la opción, o llamar a la API directamente.

Generate multiple images using the API

1. Abre la documentación de la API.
2. Obtén una clave de API desde la consola de QwenCloud/ CometAPI.
3. Selecciona qwen-image-3.0 o qwen-image-3.0-pro.
4. Configura n al número de imágenes que deseas, de 1 a 6.
5. Envía tu prompt y guarda las imágenes devueltas.

Por ejemplo, establece "n": 4 para solicitar cuatro variaciones del mismo prompt.

Python example

Aquí tienes un ejemplo listo para adaptar usando la API compatible con 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!")

Instala primero los paquetes necesarios:

pip install openai requests

La API devuelve una URL de imagen para cada resultado. Las URLs de imágenes generadas son temporales, por lo que descarga las imágenes con prontitud.

Important settings

El conteo máximo de salida es seis por solicitud. Ten en cuenta que solicitar más imágenes incrementa el costo de generación.

Una distinción importante: n=4 solicita cuatro variaciones de un mismo prompt. Si quieres cuatro prompts diferentes, debes hacer solicitudes separadas o automatizar un bucle sobre tus prompts.

How Do You Edit Images with Qwen Image 3.0?

Una edición combina de una a tres imágenes de referencia con instrucciones. Explica tanto la transformación deseada como lo que no debe cambiar, por ejemplo la etiqueta del producto, el color, el ángulo de cámara o la geometría del empaque.

El siguiente ejemplo usa credenciales de Alibaba Cloud y su campo JSON de imagen para edición. Crea una clave regional de Model Studio, obtén tu ID de espacio de trabajo y configura el endpoint correspondiente. No sustituyas una clave de CometAPI en esta solicitud.

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"

La imagen de referencia a continuación proviene directamente del ejemplo oficial de la API. Es una imagen de entrada, no un resultado generado de este artículo.

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())

El endpoint compatible nativo usa JSON en /images/generations, no cargas multipart en /images/edits. No admite máscaras ni streaming. Lee el arreglo data devuelto y guarda cada URL usando el mismo bucle de descarga mostrado arriba.

Para dos referencias, incluye dos URLs en la matriz image y especifica sus roles en el prompt (p. ej., producto de la imagen uno, ambientación de la imagen dos). La serie Qwen Image 3.0 acepta no más de tres imágenes de referencia; usa otro modelo o un flujo de preprocesamiento para conjuntos de origen más grandes.

How Much Does Qwen Image 3.0 API Cost?

Los precios de la API de Qwen Image 3.0 varían según la variante del modelo, la resolución de salida y el proveedor. La tabla a continuación complementa la comparación original de Alibaba Cloud Singapur con las tarifas de CometAPI mostradas en la tabla de precios adjunta por el revisor. El adjunto lista precios de salida en USD por imagen y un descuento del 20% para las cuatro combinaciones de modelo/resolución. Estas tarifas proporcionadas no han sido revalidadas de forma independiente contra la facturación de cuentas en vivo; confirma la lista de tarifas aplicable antes de uso en producción.

*Los ejemplos de volumen anteriores cubren solo imágenes de salida: 100 imágenes Standard 1K cuestan $2.40 y 100 imágenes Pro 1K cuestan $3.20; 1,000 imágenes Standard 2K cuestan $24.00 y 1,000 imágenes Pro 2K cuestan $60.00. Para edición, agrega $0.0024 por imagen de referencia de entrada facturable. Se excluyen reglas de trabajos fallidos, impuestos y ajustes específicos de cuenta.

Usando las tarifas suministradas de imágenes de entrada y salida, estima los cargos de imagen para cualquiera de los proveedores de la siguiente manera:

Costo total = (imágenes de referencia facturables × precio por imagen de entrada) + (salidas exitosas × precio por imagen de salida).

Para un trabajo facturado por dos imágenes de referencia de entrada y tres salidas exitosas Standard 1K, los cargos de imagen de Alibaba Cloud son (2 × $0.0030) + (3 × $0.0300) = $0.0960. Los cargos de imagen correspondientes en CometAPI son (2 × $0.0024) + (3 × $0.0240) = $0.0768, con base en las tarifas suministradas.

CometAPI cobra $0.0024 por imagen de referencia de entrada para ambas variantes. Los precios de salida son $0.0240 por imagen Standard en 1K o 2K, $0.0320 por imagen Pro en 1K y $0.0600 por imagen Pro en 2K. La tabla suministrada lista cada tarifa de entrada y salida en un 20% por debajo de su precio oficial correspondiente. Para los mismos conteos de imágenes facturables, estos cargos de imagen son por tanto un 20% menores; tarifas adicionales o términos de cuenta pueden cambiar la factura final.

Para la presupuestación de producción, verifica la variante seleccionada, la resolución de imagen, los cargos por imágenes de referencia, el número de salidas por solicitud y los descuentos de cuenta aplicables antes de estimar los costos de uso totales.

How Do You Handle Qwen Image 3.0 API Errors?

FAQ

Should I retry a Qwen Image 3.0 request after a timeout?

Un timeout del cliente no prueba que la generación se haya detenido. Conserva cualquier identificador de solicitud o tarea, consulta el historial de trabajos del proveedor o la API de estado documentada y determina si ya existe salida antes de reenviar. Reintentos a ciegas pueden crear trabajos duplicados y cargos adicionales. Usa reintentos acotados para fallos transitorios y sigue la guía de idempotencia del proveedor cuando esté disponible.

How can I use local reference images with Qwen Image 3.0?

Para la interfaz nativa compatible, lee el archivo como bytes, codifícalo en Base64 y antepone un data URI como data:image/png;base64,. Coloca esa cadena completa en image. La entrada Base64 aún debe cumplir los límites de tamaño y dimensiones; una ruta del sistema de archivos local no es una URL que el servicio pueda obtener.

How do I pass Qwen-specific options through an OpenAI SDK?

Mantén los campos estándar de imagen en sus argumentos habituales del SDK y coloca los campos de extensión de Model Studio, como image y prompt_extend, dentro de extra_body. Las solicitudes HTTP sin envolver colocan estos campos directamente en el nivel superior del JSON. Esta guía aplica a la interfaz nativa compatible; verifica la ruta seleccionada en CometAPI antes de reenviar opciones específicas del proveedor.

What should I do when Qwen Image 3.0 returns fewer images than requested?

Guarda primero las salidas exitosas y registra el conteo real. Para la facturación nativa de Alibaba Cloud, los cargos por salida se basan en imágenes generadas exitosamente. Si se necesitan recursos adicionales, solicita solo la cantidad faltante después de revisar la respuesta y el registro de uso; la facturación de CometAPI debe conciliarse con sus propios términos de cuenta.

Conclusion

Qwen Image 3.0 es una opción práctica para equipos que necesitan generación y ediciones guiadas por referencias dentro de una misma familia de modelos. Usa Standard como base centrada en costos, prueba Pro para tareas 2K o creativas más exigentes y mide el costo de salida aceptada en lugar de juzgar solo por el precio por solicitud. Comienza con la llamada mínima de generación, persiste sus salidas y luego agrega edición o múltiples salidas según el contrato del proveedor correspondiente. Mantén separadas las credenciales y los esquemas de solicitud, maneja errores explícitamente y concilia el uso de imágenes con la lista de tarifas seleccionada.