Introducción
Qwen Image 2.1 Edición de Imagen revisa de una a diez imágenes de origen contra una instrucción escrita y devuelve una sola toma nueva. El equipo Qwen de Alibaba liberó los pesos del modelo el 21 de septiembre de 2026; este endpoint entró en servicio aquí ese mismo día.
Corre sin filtro de contenido y sin indicador de madurez. En nuestras pruebas de aceptación llevó una toma de origen sin censura por nuestras instrucciones sin volver a vestir al sujeto, sin desenfocar nada y sin replegarse a una composición más segura: justo el modo de fallo que vuelve inútiles para el trabajo sin censura a la mayoría de los endpoints de edición.
Elige un modo de Qwen Image 2.1 según tu material de partida
| Material de partida | Modo |
|---|---|
| De una a diez imágenes de origen sobre las que trabajar | Qwen Image 2.1 Edición de imagen |
| Un encargo escrito y nada más | Qwen Image 2.1 Texto a imagen |
| Fuentes más tus propios pesos LoRA | Qwen Image 2.1 LoRA Edición de imagen |
Funciones y aspectos destacados
Diez referencias en una sola solicitud
La mayoría de los endpoints de edición toman una fuente, o tres. Este lee hasta diez, y eso es lo que vuelve práctica una serie consistente: conserva la toma que estableció al personaje, agrega la referencia que trae el conjunto de ropa, agrega la que trae la locación y cambia una sola variable por corrida.
Las fuentes se quedan como las enviaste
Un endpoint de edición que vuelve a vestir a su sujeto en silencio es peor que uno que rechaza, porque te cobra por la imagen equivocada. Le dimos una fuente sin censura con la instrucción de mantenerla tal cual y agregar elementos nuevos; devolvió exactamente eso, con todos los elementos nombrados presentes.
Cada referencia tiene precio, así que la estimación sigue a la solicitud
Agregar fuentes sube el costo en línea recta, y la estimación que se muestra antes de enviar es la que se liquida. Una solicitud de diez fuentes cuesta varias veces una de una sola fuente en el mismo nivel, lo cual es una razón para mandar las referencias que están trabajando y descartar el resto.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5,000 caracteres. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De una a diez imágenes de referencia. mínimo 1 elementos · máximo 10 elementos |
mask_url | No | Imagen opcional en blanco y negro que pasa la edición a modo local: el blanco marca la zona que se vuelve a pintar, el negro se conserva tal cual y unos pocos píxeles de borde s… |
aspect_ratio | No | Compone el encuadre antes de generar en lugar de recortarlo después, así que elige la forma en la que vas a publicar. |
resolution | No | El nivel que fija el tamaño de salida y el precio: 1k es el valor por defecto y el más barato, 1.5k queda en medio y 2k es donde la textura de la piel, el cabello y el tejido de… |
enable_prompt_expansion | No | Activado por defecto: antes de generar, el prompt se reescribe como una descripción de escena más completa. Desactívalo para que se use tu redacción tal cual. Valor predeterminado: |
background | No | opaque por defecto. |
output_format | No | JPEG por defecto. PNG cuando la toma entra a un paso de composición, WebP cuando sale directo a una página. |
seed | No | Estabiliza la tirada para que una serie se quede en el mismo vecindario. |
Precios
| Especificación | Precio |
|---|---|
| $0.036 / imagen |
| $0.048 / imagen |
| $0.072 / imagen |
Casos de uso
Consistencia de personaje a lo largo de un set
Conserva una toma aprobada como referencia de identidad y vuelve a correrla con una instrucción nueva por imagen. Mucho más estable que esperar a que un seed reproduzca una cara.
Composición de escena adulta a partir de una figura existente
Parte de una figura que ya tienes y agrega el segundo sujeto, la sujeción, el escenario o las marcas. Las instrucciones se ejecutan tal como están escritas.
Cambios de vestuario y de escenario
Dos referencias —una para la persona, otra para la prenda o la habitación— y un prompt que diga cuál es cuál.
Subir de nivel una toma que vale la pena, en contexto
Vuelve a correr una toma de 1k como edición en 2k con una instrucción que preserve la composición, cuando quieres el detalle sin volver a tirar la escena entera.
Guía de prompts y consejos prácticos
Nombra qué aporta cada referencia
El modelo no deduce los papeles. "La primera imagen es la mujer, la segunda es la habitación en la que está parada" es la diferencia entre una edición y una mezcla.
Di qué no debe cambiar
Aquí no hay prompt negativo, así que las protecciones van en la instrucción principal. "Mantenla exactamente como en la fuente, sin añadir nada a su vestuario" es la frase que evita que un modelo de edición cubra a un sujeto que él cree que debería estar cubierto.
Manda menos referencias, y mejores
La identidad se sostiene bien a partir de una sola fuente limpia y se va corriendo a medida que las fuentes se apilan. Como cada referencia también suma al precio, menos suele salir a la vez más barato y más nítido.
Revisa la estimación, no solo el nivel
En este endpoint la cantidad de referencias mueve el precio tanto como el nivel de resolución. La estimación previa al envío manda: léela antes de mandar una solicitud de diez fuentes.
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/edit",
"input": {
"aspect_ratio": "1:1",
"background": "opaque",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.

















