Introducción
Qwen Image 2 Edición de imagen recibe exactamente una imagen de referencia y una instrucción, y devuelve un resultado editado: con otra luz, otro estilo, otra ropa o con rótulos añadidos, según lo que describa el prompt.
Qwen Image 2 es el modelo de imagen de uso general de Alibaba: prompts de hasta 800 caracteres leídos de forma nativa en chino o inglés, cinco relaciones de aspecto en texto a imagen y un endpoint de edición que revisa una referencia en la proporción que elijas. Una imagen por solicitud, con un seed opcional para mantener fija una tirada mientras comparas.
Elige un modo de Qwen Image 2 según tu material de partida
| Material de partida | Modo |
|---|---|
| Una dirección de arte o un brief de diseño por escrito | Qwen Image 2 Texto a imagen |
| Una imagen fuente aprobada que quieres revisar | Qwen Image 2 Edición de imagen |
Funciones y aspectos destacados
Prompts en dos idiomas
Qwen Image 2 lee directamente prompts en chino y en inglés, así que el equipo puede trabajar en el idioma donde el brief queda más claro, sin reescribirlo para la entrega.
Un cambio escrito sobre una imagen dada
El modo de edición parte de una imagen que tú aportas y de una instrucción escrita. Úsalo cuando la identidad o la composición ya existen y lo que se revisa es un cambio deliberado, no un concepto nuevo.
Dos puntos de partida bien separados
Texto a imagen sirve para levantar una escena nueva desde la dirección de arte; la edición sirve para revisar una imagen fuente. Elegir primero el material de partida evita juzgar un brief de edición como si fuera una generación desde cero.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 800 caracteres que describan el resultado, no la fuente. Di qué debe quedar idéntico y qué cambia; lo que no se diga puede desviarse. mínimo 1 caracteres · máximo 800 caracteres |
image_urls | Sí | Exactamente una URL jpeg, png o webp accesible públicamente, de una imagen sobre la que tengas derechos. mínimo 1 elementos · máximo 1 elementos |
aspect_ratio | No | 1:1 por defecto, o 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 y 21:9. La salida no sigue la forma de la fuente, así que fija la proporción de tu foto siempre que importen sus proporciones. |
seed | No | Déjala fuera para un sorteo nuevo en cada llamada; fíjala para comparar dos redacciones de la misma edición contra un sorteo idéntico. |
Precios
$0.035 / imagen
Casos de uso
Pulir una imagen que ya tienes
Usa este modo cuando una foto existente deba fijar el sujeto, la composición o el estilo. Envíala como única entrada de image_urls, di qué cambia y qué debe quedar idéntico, y compara el resultado con el original al tamaño en que se va a usar.
Un producto en una escena nueva
Envía la foto del producto y describe el entorno donde debe estar, incluida la luz que tiene que recibir. Una llamada, un fotograma. Si el entorno tiene que salir de una segunda foto, usa un modelo de edición que acepte varias referencias.
Producción de campañas bilingüe
Adapta una pieza clave aprobada a otro mercado pidiendo un rótulo sobre una superficie libre, escrito en el prompt exactamente como debe leerse, en chino o en inglés. Que sea una cadena corta: los letreros y los textos largos son trabajo de la línea Qwen Image 3.0.
Personajes y vestuario
Conserva a la persona de una foto y describe la prenda nueva con palabras, incluidos tejido y brillo. Ajusta aspect_ratio a la forma de la foto —por defecto es 1:1— para que el resultado no se convierta en un cuadrado que no pediste.
Guía de prompts y consejos prácticos
Elige el encuadre antes de escribir
La forma de la salida la define aspect_ratio, no la imagen de origen. Por defecto es 1:1 y hay ocho proporciones, entre ellas 3:2, 2:3 y 21:9; fija la que corresponde a tu foto antes de escribir la instrucción.
Gasta los 800 caracteres en una escena completa
Describe el resultado, no el original. Di primero qué debe quedar idéntico, luego qué cambia, y usa el resto en el nuevo set y la luz: todo lo que no se diga puede desviarse.
Adapta el ejemplo incluido
Parte del ejemplo publicado y cambia la dirección creativa, pero conserva el contrato de entrada de este modo.
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
Una reubicación con una sola referencia: se conservan la mujer y la bata, el bar con neones se describe con palabras y se pide de forma explícita que la luz coincida. La imagen la pones tú: la URL de aquí es un marcador, no una muestra alojada.
Revisa el resultado antes de iterar
Aquí no hay control de intensidad y se acepta exactamente una referencia: una segunda se rechaza antes de que la solicitud salga de la plataforma. aspect_ratio vale 1:1 por defecto y no sigue al original, así que una foto vertical vuelve cuadrada si no fijas la proporción. Cuánto sobrevive del original depende de lo concreta que sea la instrucción. Fija seed cuando quieras comparar dos redacciones de la misma edición sobre una tirada idéntica.
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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.


















