Inicio Blog

Cómo usar la API Qwen Image 2.1

Portada del blog de la API Qwen Image 2.1

Oct 18, 2026

EmpirioLabs AI

Qwen Image 2.1 está disponible en EmpirioLabs. Es el modelo de generación y edición de imágenes de Alibaba, que funciona como un ID de modelo con dos variantes: Pro para la mayor calidad de imagen y ediciones complejas, y Turbo para generación más rápida y de menor coste. Ambos funcionan a través de DESPUÉS /v1/images/generations, en la API y en la Playground.

Mira el vídeo de lanzamiento

Cada imagen de la película es una salida real de Qwen Image 2.1. La banda sonora fue generada por ACE-Step en EmpirioLabs. Míralo en YouTube.

¿Pro o turbo?

VarianteMejor opciónFacturación
qwen-image-2.1-proRecursos finales, diseños con mucho texto y ediciones complejas de múltiples imágenesUna tasa por imagen de salida en cada tamaño
qwen-image-2.1-turboBorradores, generación de alto volumen y ediciones rutinariasUna tasa menor por imagen de salida en cada tamaño

Pro es el valor predeterminado. Ambas variantes aceptan hasta diez imágenes de referencia y devuelven hasta seis imágenes por solicitud. Elige una variante con model_variant; los IDs de los modelos qwen-image-2.1-pro y qwen-image-2.1-turbo También selecciona uno directamente.

Generar una imagen

Set Sincronización: Verdadero para recibir la imagen terminada en la respuesta. Sin ella, la solicitud devuelve un trabajo para sondear ¡QUE /v1/jobs/{id}.

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "Autorización: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Contenido: application/json" \ -d '{ "modelo": "qwen-image-2-1", "model_variant": "qwen-image-2.1-turbo", "prompt": "Un mercado nocturno bajo la lluvia, faroles de papel reflejados en charcos, un cartel pintado a mano que dice ABIERTO TARDE", "resolución": "1K", "aspect_ratio": "16:9", "num_images": 2, "sync": verdadero }'

Edición con imágenes de referencia

Adjunta de una a diez imágenes en Imágenes, y el prompt se convierte en la instrucción de edición:

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "Autorización: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Contenido: application/json" \ -d '{ "modelo": "qwen-image-2-1", "imágenes": [ "https://example.com/product.png", "https://example.com/kitchen.png" ], "prompt": "Coloca la botella de la primera imagen sobre el encimera de mármol de la segunda imagen, con luz suave de la mañana.", "tamaño": "2048*1536", "negative_prompt": "etiqueta distorsionada, botella duplicada", "semilla": 4242, "sincronización": verdadero }'

Imágenes transparentes

Salida PNG transparente. Las salidas son archivos PNG. Para un fondo transparente, establece prompt_extend a falso y describe la imagen en esta forma:

{ "modelo": "qwen-image-2-1", "prompt": "Esta es una imagen RGBA con transparencia. Una taza de café cerámica con un esmalte azul. La imagen tiene canal alfa y el fondo es transparente.", "prompt_extend": falso, "resolución": "1K", "aspect_ratio": "1:1", "sync": verdadero }

Tamaños

  • Presets. Set resolución a 1K, 2K, o Auto, y aspect_ratio a Auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, o 4:5. Los valores por defecto, 2K y automático, devuelven una imagen de 2048x2048.
  • Tamaños exactos. Enviar Tamaño como ANCHO*ALTURA, o conjunto use_custom_size con custom_width y custom_height. El área total debe mantenerse entre 512x512 y 2560x2560 píxeles, con una relación de aspecto de 1:8 a 8:1.
  • Largas banderas. El límite es por área, por lo que un lado puede superar los 2560 píxeles: 4096*512 es un tamaño válido.

Notas operativas

  • La extensión de prompt del agente es solo para text-to-image. Una petición que adjunta imágenes con prompt_extend_mode Establecido a agente falla. Usa Directo, el valor predeterminado, cuando editas.
  • La resolución automática con una relación de aspecto fija utiliza el preajuste de 1K. Resolución: "Auto" con aspect_ratio: "16:9" Retorna 1920x1080. Conjunto resolución a 2K para el tamaño más grande.

Precios

Cada imagen de salida se factura a la tarifa de su variante, que es la misma en todos los tamaños. Turbo es la variante de menor coste, y las imágenes de referencia no aportan coste. Ver la transmisión en directo página modelo y página de precios para las tarifas actuales.

Plantillas y Componer

Qwen Image 2.1 también está disponible en el Plantillas de generación y como modelo de imagen en Compose.

Empieza a construir

Prueba la imagen 2.1 de Qwen en el Playground, y lee el Documentación de la API para cada parámetro y campo de respuesta.

Divulgación: Este artículo fue escrito con asistencia AI y revisado por EmpirioLabs AI.

¿Listo para usar mejores endpoints?

Explora nuestros modelos o contáctanos para consultas empresariales, despliegues personalizados o cualquier otra cosa.