Introducción
Qué hace este endpoint
Qwen Image 2.1 Pro Texto a imagen convierte un encargo escrito en una a seis imágenes por solicitud con el nivel Pro alojado de Qwen Image 2.1 de Alibaba. Nuestras solicitudes tardaron de 14 a 43 segundos de extremo a extremo.
Entradas
prompt lleva el encargo completo, hasta 5.000 caracteres. num_outputs pide de una a seis imágenes. aspect_ratio elige una de quince formas y resolution el nivel 1k, 1.5k o 2k, todos al mismo precio por imagen. enable_prompt_expansion (desactivada por defecto) deja que Alibaba reescriba primero el prompt, y prompt_optimization_mode y enable_thinking dan forma a esa reescritura. seed estabiliza una serie.
Contenido
Sin filtro de la plataforma. Con la expansión desactivada, todas las pruebas de contenido que hicimos salieron tal como se pidieron.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Imagen |
| Estado en SpicyAPI | Activo: texto a imagen y edición de imágenes |
| Basado en | Qwen Image 2.1, como nivel Pro alojado de Alibaba |
| Imágenes por solicitud | De 1 a 6, facturadas por imagen devuelta |
| Precio | Un precio fijo por imagen en los niveles 1k, 1.5k y 2k; la cotización en vivo está en esta página |
| Relaciones de aspecto | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Tamaños en 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Edición | De 1 a 10 imágenes de referencia; sin relación de aspecto, la salida sigue a la imagen de origen en torno a 2K |
| Prompt | Hasta 5.000 caracteres; sin prompt negativo, así que escribe las exclusiones dentro del prompt |
| Expansión de prompt | Desactivada por defecto; reescritura direct o agent cuando está activada, con una pasada de razonamiento opcional |
| Espera medida | De 14 a 43 segundos para texto a imagen y de 39 a 48 segundos para ediciones, en nuestras pruebas |
| Política de contenido | Sin censura: sin filtro de la plataforma ni indicador de madurez |
| Pesos | No publicados; Alibaba ofrece Pro como API alojada |
Funciones y aspectos destacados
Una cabecera bien escrita a la primera
Entrecomilla las palabras e indica dónde van. "AFTER DARK" en la parte superior y el pequeño titular de portada debajo salieron letra por letra, en las dos imágenes de la solicitud.
Dos retratos, una mesa a la luz de las velas
Un hombre y una mujer fotografiados por separado, nombrados como Image 1 e Image 2, acaban en una misma mesa en una terraza de viñedo, con ambos rostros aún reconocibles y el vestido de ella cambiado como se pidió.
Pro o Turbo, sin reescribir ni una línea
Pro y Turbo leen los mismos campos en SpicyAPI, así que un prompt que funciona en uno puede enviarse al otro sin cambios. Haz borradores rápidos en Turbo y guarda los encuadres que importan en Pro, o al revés.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | El encargo completo, hasta 5.000 caracteres. Escribe sujeto, vestuario, pose, luz y objetivo en frases sencillas. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Quince formatos, desde las franjas 3:1 y 21:9 hasta las columnas 1:3 y 9:21. El encuadre se compone en ese formato, no se recorta de un cuadrado. |
resolution | No | 1k, 1.5k o 2k. Todos los niveles cuestan lo mismo por imagen, así que 2k es el valor por defecto. |
num_outputs | No | De una a seis imágenes del mismo prompt en una sola solicitud. Cada imagen devuelta se factura, así que seis imágenes cuestan seis veces una. |
enable_prompt_expansion | No | Desactivada por defecto, así que tu redacción se dibuja tal como la escribes. Valor predeterminado: |
enable_thinking | No | Dedica razonamiento extra a la reescritura para obtener una mejor imagen, a costa de una espera más larga. Solo funciona mientras la expansión de prompt está activada. Valor predeterminado: |
prompt_optimization_mode | No | Cómo reescribe la expansión el encargo cuando está activada: direct es una sola pasada que sirve para la mayoría de los prompts; agent es una reescritura en varios pasos con más… |
seed | No | Estabiliza una tirada para que puedas cambiar una sola cosa cada vez y comparar con justicia. No garantiza una imagen idéntica píxel a píxel. |
Precios
$0.036 / imagen
Casos de uso
Trabajo de imagen sin censura
SpicyAPI no pone ningún filtro de contenido delante de Pro. Con la expansión de prompt desactivada, nuestras pruebas salieron tal como se escribieron en cada nivel de intensidad que probamos, desde Suave hasta Máximo, con sujetos femeninos y masculinos por igual.
Portadas y carteles con texto exacto
Alibaba destaca una tipografía mejorada en Pro. Entrecomilla la cabecera y el titular de portada, indica dónde va cada uno y describe la fotografía: nuestra portada de revista salió con ambas líneas escritas exactamente, en las dos imágenes de la solicitud.
Un mismo personaje en toda una serie
Genera un personaje, envía el encuadre de vuelta como referencia y cambia el atuendo, la habitación o la luz en pasadas separadas. Cada edición parte de tu encuadre aprobado en lugar de una tirada nueva, así que el rostro se mantiene en toda la serie.
Parejas a partir de dos retratos
Envía dos retratos como Image 1 e Image 2 y describe la escena que comparten. En nuestra prueba, un hombre y una mujer fotografiados por separado acabaron en una misma mesa a la luz de las velas en una terraza de viñedo, ambos aún reconocibles.
Retratos con atmósfera e iluminación
Alibaba señala la iluminación de retratos y el detalle fino como los puntos fuertes de Pro. Nombra una sola fuente de luz y dónde cae, un farol de tormenta, una ventana alta, una aplique, y el encuadre se construye a su alrededor.
Muchos borradores antes de uno definitivo
Hasta seis imágenes por llamada a un precio fijo hacen un abanico barato de opciones. Explora vestuario, pose y luz en una sola solicitud, quédate con el encuadre que funcione y dedica tus ediciones a ese.
Guía de prompts y consejos prácticos
Deja la expansión de prompt desactivada cuando importe la redacción
La expansión entrega tu prompt al reescritor de Alibaba antes de dibujar la imagen, y esa reescritura puede suavizar una solicitud atrevida. Aquí viene desactivada por defecto, y todas las pruebas de contenido que hicimos con ella desactivada salieron tal como se escribieron. En nuestra única prueba Pro con la expansión activada, un prompt que la app oficial bloquearía sí pasó, pero déjala desactivada siempre que la redacción exacta importe.
Actívala para prompts cortos de uso cotidiano
Un encargo de seis palabras obtiene una escena más completa con la expansión activada. direct reescribe en una sola pasada y sirve para la mayoría de los prompts; agent reescribe en varios pasos para un resultado más fino. El modo de razonamiento dedica razonamiento extra a esa reescritura y añade tiempo; no hace nada mientras la expansión está desactivada.
Usa 2K, cuesta lo mismo
Todos los niveles tienen el mismo precio por imagen, así que 2K es el valor por defecto y la opción sensata. Baja a 1k solo cuando quieras un archivo más pequeño o una respuesta algo más rápida.
Pide varias imágenes a la vez
Fija
num_outputsde 1 a 6 para obtener variaciones de un mismo prompt en una sola llamada. Cada imagen devuelta se factura, así que seis imágenes cuestan seis veces una. Es la forma más económica de encontrar una pose o una composición que te guste antes de empezar a editar.Edita con el cambio primero y la lista de lo que se conserva después
Escribe primero lo único que cambia y luego todo lo que debe mantenerse: «Cambia su vestido de terciopelo por un vestido de noche marfil; mantén su rostro, su pelo y su expresión». Nombra las referencias por número. En nuestra prueba con dos retratos, «el hombre de la imagen 1 y la mujer de la imagen 2» en una mesa iluminada con velas mantuvieron ambos rostros reconocibles en un mismo encuadre.
Entrecomilla las palabras que deben aparecer
Pon la redacción exacta entre comillas e indica dónde va. Nuestra portada de revista, con "AFTER DARK" arriba y "THE SILK ISSUE · NO. 07" en letra pequeña debajo, salió letra por letra. Mantén cada línea corta y compruébala a tamaño completo antes de publicar.
Escribe el prompt en un orden fijo
Sujeto, vestuario, pose, luz, objetivo y paleta, en frases sencillas. Nombra la fuente de luz y su dirección (una lámpara de aceite a la izquierda, un haz giratorio detrás de ella) en lugar de una palabra de ambiente. Con la expansión desactivada, Pro dibuja lo que escribes y no rellena los huecos por ti.
Introducción
Qwen Image 2.1 Pro Texto a imagen convierte un encargo escrito en imágenes. Pro es el nivel alojado de Qwen Image 2.1 de Alibaba, que Alibaba anunció como oficialmente activo junto con la API de Turbo el 9 de octubre de 2026 y que describe como un equilibrio entre calidad de generación, eficiencia de inferencia y costo, con tipografía, iluminación de retratos y detalle fino mejorados. Alibaba lo ofrece como API y no ha publicado pesos para él.
En SpicyAPI está activo. Una solicitud devuelve de una a seis imágenes, los niveles 1k, 1.5k y 2k cuestan lo mismo por imagen y no hay ningún filtro de contenido delante del modelo. Todas las imágenes de esta página se generaron con Pro y con el prompt que se muestra.
Elige un modo según lo que tengas
| Material de partida | Modo |
|---|---|
| Un encargo escrito y nada más | Qwen Image 2.1 Pro Texto a imagen |
| Una o más imágenes que cambiar | Qwen Image 2.1 Pro Edición de imágenes |
Lo que medimos
Velocidad
De 14 a 31 segundos para una sola imagen y de 39 a 43 segundos para dos imágenes 2K en una llamada, de extremo a extremo en nuestras pruebas. La expansión de prompt y el modo de razonamiento añaden tiempo cuando están activados.
Contenido
Con la expansión de prompt desactivada, que es lo predeterminado, todas las pruebas de contenido salieron tal como se escribieron, desde Suave hasta el nivel Máximo, con un sujeto femenino y uno masculino. Ni una sola solicitud fue rechazada. En nuestra única prueba con la expansión activada, un prompt sin filtro también salió tal como se pidió.
Texto dentro de la imagen
Nuestra portada de revista pedía "AFTER DARK" como cabecera y "THE SILK ISSUE · NO. 07" debajo, y obtuvo ambos, letra por letra, en las dos imágenes de la solicitud.
Tamaños en 2K
| Relación | Tamaño de salida |
|---|---|
| 1:1 | 2048 × 2048 |
| 16:9 | 2688 × 1536 |
| 9:16 | 1536 × 2688 |
| 4:3 | 2368 × 1760 |
| 3:2 | 2496 × 1664 |
| 2:3 | 1664 × 2496 |
Quince relaciones en total, de 3:1 a 1:3, en 1k, 1.5k y 2k. La salida es PNG.
Pro o Turbo
| Pro | Turbo | |
|---|---|---|
| Qué es | Nivel Pro alojado de Alibaba | Checkpoint de 8 pasos |
| Pesos | No publicados | Abiertos, Qwen Research License |
| Imágenes por solicitud | De 1 a 6 | De 1 a 6 |
| Precio según el nivel | Fijo | Fijo |
| Precio por imagen | Más alto | Más bajo |
| Filtro de contenido | Ninguno | Ninguno |
La solicitud es la misma, así que puedes enviar un mismo prompt a ambos y quedarte con el resultado que prefieras. Alibaba no ha publicado una comparación de calidad entre ellos.
Guía de prompts y consejos Pro
Mantén la expansión desactivada para una redacción exacta
La reescritura puede suavizar una solicitud atrevida. Desactivada, Pro dibuja lo que escribes.
Activa la expansión para prompts cortos de uso cotidiano
Una idea de seis palabras obtiene una escena más completa. direct sirve para la mayoría de los prompts, agent reescribe con más detalle y el modo de razonamiento dedica tiempo extra a una mejor reescritura.
Escribe en un orden fijo
Sujeto, vestuario, pose, luz, objetivo y paleta, en frases sencillas. Nombra la fuente de luz y su dirección en lugar de una palabra de ambiente.
Entrecomilla las palabras que deben aparecer
Pon la redacción exacta entre comillas, mantén cada línea corta e indica dónde va.
Pide seis, quédate con una
Cada variación cuesta lo mismo, así que una solicitud de seis imágenes es la forma más rápida de encontrar la pose o la composición que merece editarse.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2.1-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
















