API de Qwen-Image 3.0 Pro

Accede a Qwen-Image 3.0 Pro a través de GoEnhance con un único endpoint para generar imágenes desde texto y editar con referencias. Envía un prompt, añade opcionalmente hasta tres URL de imagen, recibe un img_uuid y después consulta por sondeo o usa callbacks. GoEnhance ofrece un acceso independiente y no es la API oficial de Alibaba.
Crear una API Key
Ilustración de estudio sin marcas que representa la generación de imágenes con la API de Qwen-Image 3.0 Pro

Un solo endpoint para generar y editar

Generar a partir de un prompt

Omite image_list para generar solo desde texto. Elige una relación de aspecto compatible y una salida 1K o 2K, o deja que ratio: auto decida la composición.
Paisaje de fantasía de una sola escena con gran detalle que representa la generación de imágenes desde texto

Edita con hasta tres referencias

Añade de una a tres URL de imagen accesibles en image_list. Su orden determina cómo el prompt se refiere a cada fuente; cada referencia debe pesar menos de 10MB.
Bodegón de estudio coherente que representa la edición de imágenes guiada por referencias
Valida el modo de la petición, la relación de aspecto, el nivel y los controles opcionales antes de enviarla.

Parámetros de la API de Qwen-Image 3.0 Pro

Modelo obligatorio

Define model como qwen-image-3-pro.

Prompt

Envía un prompt de texto obligatorio de 1 a 2000 caracteres.

Relación de aspecto

Elige auto o una de las 13 relaciones documentadas, desde 1:1 hasta 8:1.

Nivel de salida

Define image_size como 1K o 2K; el valor por defecto es 2K.

Imágenes de referencia

De forma opcional, pasa de uno a tres objetos de URL en image_list, cada uno por debajo de 10MB.

Controles del prompt

Opcionalmente añade un prompt negativo, una semilla de 0 a 2147483647 o prompt_extend_mode. El modo agent solo sirve para texto a imagen.
El coste depende del nivel de salida más un recargo por cada imagen de referencia.

Precios de la API de Qwen-Image 3.0 Pro

Salida 1K

El precio documentado es de 2.43 tokens ($0.049) por cada imagen 1K generada.

Salida 2K

El precio documentado es de 4.85 tokens ($0.097) por cada imagen 2K generada. Las peticiones con ratio: auto se facturan en este nivel.

Recargo por referencia

Cada imagen de referencia suma 0.19 tokens ($0.0039). Las relaciones 1:8 y 8:1 se limitan al nivel 1K, y se facturan como tal.

Integra Qwen-Image 3.0 Pro en tres pasos

1

1. Construye y valida

Elige entre texto a imagen o edición con referencias, escribe el prompt, valida las relaciones de aspecto y las URL de imagen, y añade tu cabecera de autorización.
2

2. Envía y guarda

Envía la petición por POST con model: qwen-image-3-pro y guarda el img_uuid devuelto.
3

3. Gestiona el final

Sondea GET /api/v1/jobs/detail o acepta eventos de callback HTTPS hasta que la tarea termine con éxito o falle; después guarda el resultado o gestiona el error.
Crear una API Key
Admite tanto la generación de imágenes nuevas como flujos controlados basados en referencias.

Casos de uso de la API de Qwen-Image 3.0 Pro

Visuales de producto

Genera conceptos de escena listos para campaña o lleva referencias de producto ya aprobadas a nuevos entornos.

Variaciones de anuncios

Produce direcciones visuales guiadas por el prompt para banners, medios de pago y pruebas creativas de temporada.

Prototipos de diseño

Convierte la dirección de arte escrita en conceptos visuales antes de pasar a producción completa.

Reestilizado con referencias

Usa hasta tres referencias ordenadas para guiar la composición, los detalles del sujeto o el tratamiento visual.

Campañas localizadas

Crea variaciones de escena por región manteniendo el mismo contrato de integración.

Cadenas de contenido

Conecta la generación asíncrona con los sistemas de moderación, revisión, almacenamiento y publicación de tu aplicación.
Respuestas sobre precios, entradas, entrega asíncrona y la intención de búsqueda de la API de Alibaba.

Preguntas frecuentes sobre la API de Qwen-Image 3.0 Pro

¿Cuánto cuesta la API de Qwen-Image 3.0 Pro?

GoEnhance documenta 2.43 tokens ($0.049) por salida 1K y 4.85 tokens ($0.097) por salida 2K, más 0.19 tokens ($0.0039) por cada imagen de referencia.

¿Es esta la API oficial de Alibaba?

No. Qwen está asociado a Alibaba, mientras que esta página describe un acceso independiente a la API proporcionado por GoEnhance. No implica ninguna asociación ni respaldo. Quienes necesiten una API operada por Alibaba deben consultar la documentación de Alibaba Cloud.

¿El endpoint puede generar y editar imágenes?

Sí. Omite image_list para generar desde texto o incluye de una a tres URL de imágenes de referencia para editar. El endpoint devuelve una imagen generada.

¿Qué relaciones de aspecto se admiten?

Los valores documentados son auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 1:2, 2:1, 1:4, 4:1, 1:8 y 8:1.

¿Cómo funciona la extensión del prompt?

El modo por defecto direct usa el prompt tal cual. agent lo reescribe de forma más profunda, pero solo es válido en peticiones de texto a imagen sin image_list.

¿La API devuelve la imagen al instante?

No. Un envío correcto devuelve un img_uuid. Sondea el endpoint de detalle del trabajo o usa eventos de callback para obtener el resultado final.

¿Qué pasa si mi callback no está disponible?

Si tu endpoint no devuelve HTTP 200, GoEnhance documenta hasta tres reintentos de callback con un tiempo de espera de tres segundos por intento. El sondeo sigue siendo una vía práctica de recuperación.

Desarrolla con la API de Qwen-Image 3.0 Pro