API de Qwen-Image 3.0

Genera o edita una imagen a través de GoEnhance con el modelo qwen-image-3. Usa solo un prompt para texto a imagen, o añade de una a tres URL de referencia para editar imágenes. GoEnhance ofrece un acceso independiente a la API; no es una API oficial de Alibaba ni una empresa afiliada a Alibaba.
Crear una API Key
Escena de estudio abstracta que representa la generación con la API de Qwen-Image 3.0

Generación y edición en un mismo flujo

Un endpoint, dos modos

Envía un POST a /api/v1/images/generations con model: qwen-image-3. Indica solo un prompt para texto a imagen, o incluye de una a tres URL de imágenes de referencia accesibles para editar. Cada petición devuelve una imagen.
Objetos de arte en vidrio en una única escena de estudio que sugieren generación y edición de imágenes

Resultados asíncronos por diseño

Un envío correcto devuelve un img_uuid. Guárdalo, consulta GET /api/v1/jobs/detail mediante polling o indica una URL de callback HTTPS pública para recibir los cambios de estado processing, success y failed.
Corredor de datos sin marca con una estela de luz continua que representa la entrega asíncrona
Valida los campos documentados antes de enviar una tarea de generación o edición.

Parámetros de la API de Qwen-Image 3.0

ID del modelo

Asigna a model exactamente el valor qwen-image-3.

Prompt

Escribe de 1 a 2000 caracteres describiendo la imagen o la edición deseada.

Relación de aspecto

Usa auto o una relación documentada desde 1:1 hasta 1:8 y 8:1.

Nivel de salida

Elige 1K o 2K; el valor por defecto documentado es 2K.

Imágenes de referencia

De forma opcional, indica de una a tres URL de imágenes, cada una de menos de 10 MB, para editar.

Controles del prompt

Opcionalmente puedes definir un prompt negativo, una semilla y el modo de expansión direct o agent.
El precio se calcula con la salida más el recargo por imágenes de referencia.

Precios de la API de Qwen-Image 3.0

Precio de salida

Cada salida en 1K o 2K cuesta 1.75 tokens, equivalentes a $0.035 por imagen generada.

Recargo por referencia

Cada imagen de referencia añade 0.19 tokens, equivalentes a $0.0039 por imagen de referencia.

Cálculo de la tarea

Una petición con dos referencias cuesta 2.13 tokens: 1.75 + (2 × 0.19).

Integra la API de Qwen-Image 3.0

1

Crear la petición

Envía tu credencial de API en la cabecera Authorization y haz un POST con un cuerpo JSON que incluya model y prompt. Añade la relación de aspecto, el tamaño de imagen o las URL de referencia solo cuando haga falta.
2

Guardar el ID de la tarea

Comprueba que llega code: 0 y guarda el img_uuid devuelto. Trata las respuestas de tokens insuficientes y de autenticación como fallos, no como resultados de imagen.
3

Resolver la finalización

Consulta el endpoint de detalle del job mediante polling o usa un callback HTTPS público. Acepta el recurso solo cuando la tarea llegue a success y gestiona el estado failed de forma explícita.
Crear una API Key
Añade generación de imágenes y ediciones controladas a tus flujos de producción sin montar tu propia infraestructura de servicio de modelos.

Casos de uso para desarrolladores

Visuales de producto

Crea conceptos de producto listos para campaña a partir de prompts estructurados.

Variaciones creativas

Genera nuevas direcciones visuales para anuncios, publicaciones y landing pages.

Ediciones guiadas por referencias

Transforma de una a tres referencias aportadas conservando la intención del prompt.

Campañas localizadas

Produce conceptos visuales para cada mercado a partir de briefings creativos localizados.

Pipelines de recursos

Encola trabajos de generación asíncronos dentro de flujos de contenido automatizados.

Prototipado de diseño

Explora ideas de composición, material y color antes de la producción final.
Respuestas a las dudas más habituales sobre precios, entradas e integración.

Preguntas frecuentes sobre la API de Qwen-Image 3.0

¿Cuál es el endpoint de la API de Qwen-Image 3.0?

Envía peticiones POST a https://api.goenhance.ai/api/v1/images/generations con model: qwen-image-3.

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

El precio de salida documentado es de 1.75 tokens, o $0.035, tanto en 1K como en 2K. Cada imagen de referencia añade 0.19 tokens, o $0.0039.

¿La API puede editar imágenes existentes?

Sí. Añade image_list con de una a tres URL de imágenes accesibles, cada una de menos de 10 MB. Omite el campo para generar solo a partir de texto.

¿Qué relaciones de aspecto admite?

La API admite 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. Las salidas en 1:8 y 8:1 se limitan al nivel 1K.

¿Cómo funcionan los callbacks?

Indica una URL de callback HTTPS accesible públicamente. GoEnhance envía los cambios processing, success y failed con la misma forma que la respuesta de detalle del job. Los callbacks que no devuelven 200 se reintentan hasta tres veces, con un tiempo de espera de tres segundos por intento.

¿Es esta una API oficial de Alibaba?

No. Qwen está asociado a Alibaba, pero este endpoint lo proporciona GoEnhance de forma independiente. No implica ninguna asociación con Alibaba ni respaldo por su parte. Para un servicio operado por Alibaba, consulta la documentación de Alibaba Cloud.

Empieza a construir con Qwen-Image 3.0