Qwen Image 2.1 API

Generación y edición de imágenes con variantes Pro y Turbo, hasta diez imágenes de referencia, salida PNG transparente y tamaños personalizados de hasta 2560x2560.

Alibaba CloudGeneración de imágenesLanzado 2 oct 2026SingaporeEndpoint propietarioNuevo

Acerca de Qwen Image 2.1

Generación y edición de imágenes con variantes Pro y Turbo, hasta diez imágenes de referencia, salida PNG transparente y tamaños personalizados de hasta 2560x2560.

También conocido como Qwen Image, Alibaba Cloud Qwen Image 2.1

image generationimage editingmulti imagemulti referencetransparent backgroundtext rendering

Especificaciones de Qwen Image 2.1

ID del modelo
qwen-image-2-1
Autor
Alibaba Cloud
Categoría
Generación de imágenes
Lanzado
2 oct 2026
Entrada
TextoImagen
Salida
Imagen
Región
Singapore
Endpoints
POST/v1/images/generations
IDs de modelo alternativos
qwen-image-2.1qwen-image-2.1-proqwen-image-2.1-turboalibaba/qwen-image-2-1alibaba/qwen-image-2.1

Precios de la API de Qwen Image 2.1

Tarifas de pago por uso en vivo del catálogo de EmpirioLabs. Solo pagas por lo que usas, sin mínimo mensual.

Tipo
Especificación
Tarifa
Pro
por imagen
$0.040
Turbo
por imagen
$0.016
Comparar en la página completa de precios

Cómo llamar a la API de Qwen Image 2.1

Qwen Image 2.1 funciona a través de POST /v1/images/generations. La solicitud devuelve un job_id de inmediato; consulta GET /v1/jobs/{job_id} hasta que el trabajo termine y lee las URLs de salida del resultado. O agrega "sync": true para omitir el sondeo: la solicitud queda abierta y devuelve directamente la respuesta de imagen al estilo OpenAI, así que los SDKs de OpenAI funcionan tal cual. Consigue una clave de API en el panel de EmpirioLabs.

cURL: enviar el trabajo
curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2-1",
    "prompt": "Describe what you want Qwen Image 2.1 to generate."
  }'
cURL: consultar el resultado
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "qwen-image-2-1",
        "prompt": "Describe what you want Qwen Image 2.1 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
Referencia completa de la API de Qwen Image 2.1

Parámetros de la API de Qwen Image 2.1

Parámetros de solicitud compatibles con la API de Qwen Image 2.1 en EmpirioLabs. Los valores por defecto se aplican cuando se omite un campo.

ParámetroTipoPredeterminadoRango / valoresDescripción
promptstring--Describe la imagen que vas a crear. Con las imágenes de entrada adjuntas, esto se convierte en la instrucción de edición. Una edición solo de imagen utiliza un...
model_variantenumqwen-image-2.1-proqwen-image-2.1-pro, qwen-image-2.1-turboElige Pro para la mayor calidad de imagen y ediciones complejas, o Turbo para una generación más rápida y de menor coste. Cuando esto no está activado, el id del...
imagearray--De una a diez imágenes de referencia como URLs, URIs de datos o objetos de imagen subidos.
imagesarray--Alias plural para múltiples referencias de imágenes subidas.
aspect_ratioenumautoauto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5Relación de aspecto de salida opcional. El automático es el valor por defecto. Con una resolución fija de 1K o 2K, Auto utiliza el tamaño cuadrado de ese nivel. Con...
resolutionenum2Kauto, 1K, 2KPreajuste de tamaño de salida. Por defecto es 2K. Auto permite que el modelo elija el tamaño cuando la relación de aspecto es automática; con una relación de aspecto...
sizestring--Tamaño exacto de salida como ANCHO*ALTURA, por ejemplo 2048*1536. Esto anula aspect_ratio y la resolución.
use_custom_sizebooleanfalse-Usa custom_width y custom_height en lugar de los presets de relación de aspecto y resolución.
custom_widthnumber-256 a 4096Ancho de salida personalizado en píxeles. El área total debe estar entre 512x512 y 2560x2560, con una relación de aspecto de 1:8 a 8:1.
custom_heightnumber-256 a 4096Altura de salida personalizada en píxeles. El área total debe estar entre 512x512 y 2560x2560, con una relación de aspecto de 1:8 a 8:1.
num_imagesnumber11 a 6Número de imágenes de salida. Cada salida se factura por separado.
negative_promptstring--Describe elementos visuales o cualidades que debes evitar en la salida.
prompt_extendbooleantrue-Amplía el prompt automáticamente para obtener una composición y un nivel de detalle más sólidos. Desactivarlo cuando pidas un fondo transparente.
prompt_extend_modeenumdirectdirect, agentObras directas para generación y edición. El agente realiza un refinamiento más profundo de prompts y está disponible solo para solicitudes text-to-image.
3 parámetros más en la documentación

Información útil

Qwen Image 2.1 combina generación y edición de imágenes Pro y Turbo en un solo modelo. Pro está seleccionado por defecto, la salida comienza en 2K y la relación de aspecto comienza en Auto. Turbo ofrece una opción más rápida y de menor coste.

Variantes

  • Elige qwen-image-2.1-pro para la mayor calidad de imagen y ediciones complejas.
  • Elige qwen-image-2.1-turbo para una generación y ediciones rutinarias más rápidas y de menor coste.
  • Elige con model_variant. Sin él, el id del modelo qwen-image-2.1-turbo ejecuta Turbo y todos los demás id de este modelo ejecutan Pro.

Modos

  • Texto a imagen a partir de un prompt.
  • Edición de imágenes y generación guiada por referencias de una a diez imágenes.
  • La extensión de prompt directo funciona para generación y edición. La extensión de prompt de agente proporciona un refinamiento más profundo solo para solicitudes text-to-image.

Imágenes transparentes

  • Las imágenes de salida son archivos PNG. Para un fondo transparente, pon prompt_extend en falso y describe la imagen en esta forma: "Esta es una imagen RGBA con transparencia. Un frasco de cristal para perfume. La imagen tiene canal alfa y el fondo es transparente."

Límites de producción

  • De una a seis imágenes de salida por solicitud.
  • 1K, 2K, automático, preajustes de relación de aspecto o un tamaño personalizado exacto.
  • Los tamaños exactos y personalizados se mantienen entre 512x512 y 2560x2560 píxeles en área total, con una relación de aspecto de 1:8 a 8:1.

Facturación

  • Cada imagen de salida se factura a la tarifa de su variante. Las imágenes de referencia no se facturan.

Seguridad de contenido

Las imágenes generadas superan una comprobación automatizada de seguridad de contenido. No se devuelve una imagen marcada como explícita. Como la imagen se genera antes de que se ejecute la comprobación, una generación marcada sigue facturándose.

API de Qwen Image 2.1: preguntas frecuentes

¿Cuánto cuesta la API de Qwen Image 2.1?

En EmpirioLabs, Qwen Image 2.1 se factura por uso: Pro $0.040 por imagen; Turbo $0.016 por imagen. La tabla de tarifas en vivo de esta página siempre coincide con lo que cobra la API.

¿Qué endpoint usa Qwen Image 2.1?

Qwen Image 2.1 se sirve a través de POST /v1/images/generations en api.empiriolabs.ai con autenticación estándar de token Bearer.

¿Puedo probar Qwen Image 2.1 en el navegador antes de integrar?

Sí. El playground de EmpirioLabs ejecuta Qwen Image 2.1 en el navegador con los mismos parámetros que expone la API, para que pruebes prompts antes de escribir código.

¿Cómo consigo una clave de API de Qwen Image 2.1?

Crea una cuenta de EmpirioLabs y genera una clave en API Keys en el panel. La facturación es con créditos de pago por uso, así que solo pagas por las solicitudes que haces.

¿Listo para usar mejores endpoints?

Consulta nuestros precios o contacta con nosotros si quieres que tu propio modelo se implemente en nuestra pila.