Introducción
Qwen Image 3.0 Pro Edición de imagen edita de una a tres imágenes de referencia según una instrucción. Con una referencia es un cambio quirúrgico: un titular de portada, una prenda, una luz. Con dos o tres combina, siempre que el prompt diga qué aporta cada fuente.
Qwen Image 3.0 Pro es el nivel de alto detalle de la línea de imagen Qwen de Alibaba: prompts de 5.000 caracteres, ocho proporciones, un nivel de 1K o 2K y edición con una a tres referencias. Hecho para imágenes que se entregan, sin censura.
Elige un modo de Qwen Image 3.0 Pro 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 3.0 Pro Texto a imagen |
| Una imagen fuente aprobada que quieres revisar | Qwen Image 3.0 Pro Edición de imagen |
Funciones y aspectos destacados
Composición de imagen pensada para el texto
Qwen Image 3.0 Pro es útil para conceptos visuales en los que el texto aportado, la composición y el tratamiento de la imagen deben considerarse juntos. Trata las letras generadas como un borrador de diseño y revísalas antes de publicar.
Componer desde cero y revisar una fuente son trabajos distintos
Usa texto a imagen para levantar una imagen a partir de un brief escrito. Usa la edición de imagen cuando una imagen existente aporta la identidad, la composición o el material que hay que conservar mientras se hace un cambio concreto.
Revisa la jerarquía antes que el detalle decorativo
En pósteres, envases y conceptos de campaña, decide primero la jerarquía del mensaje y el punto focal. Un resultado atractivo sigue sin cumplir el encargo si el texto aprobado o los datos del producto no aparecen correctamente.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5 000 caracteres. Nombra el cambio y nombra lo que debe quedar idéntico: todo lo que no menciones queda abierto a redibujarse. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De una a tres URL accesibles públicamente, de imágenes sobre las que tengas derechos. mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | Se aplica al resultado y no a las fuentes, así que una referencia de otra forma vuelve reencuadrada. Ajústala a propósito cuando el encuadre original tenga que sobrevivir. |
resolution | No | 1k o 2k, 2k por defecto. Es la elección de nivel que cambia el precio; cada imagen de referencia en |
num_outputs | No | Fijo en 1: una imagen editada por solicitud. |
enable_prompt_expansion | No | Activa por defecto en esta familia. Rellena briefs flojos y reescribe los detallados, así que desactívala en cuanto tu prompt sea una descripción de plano precisa. Valor predeterminado: |
negative_prompt | No | Hasta 2 000 caracteres de exclusiones. Aquí sirve sobre todo contra los artefactos que invita una edición: costuras de prenda, letras sobrantes, joyas duplicadas. máximo 2000 caracteres |
seed | No | Fíjala para comparar dos redacciones de una misma instrucción contra un sorteo idéntico; déjala fuera cuando quieras variación de verdad. |
Precios
| Especificación | Precio |
|---|---|
| $0.04 / imagen |
| $0.075 / imagen |
Casos de uso
Pulir una imagen que ya tienes
Usa este modo cuando de una a tres imágenes aprobadas deban pasar al resultado. Ponlas en image_urls en el orden en que tu prompt las nombra y dale un papel a cada una —el rostro de la primera, la prenda de la segunda—, porque los papeles nunca se deducen.
Portadas de revista y editoriales sin censura
Conserva una portada aprobada y cambia un elemento por pasada: un titular, una prenda o la luz. Reestilizar y reescribir en la misma llamada es donde los rostros se desvían, así que divídelo en dos solicitudes.
Maquetas de pósteres y exterior
Toma un póster aprobado y cambia la línea de fecha o el texto legal para la siguiente tirada. Cita la cadena anterior y la nueva, mantén aspect_ratio en la forma de la imagen y describe todo lo demás como sin cambios.
Maquetas de envases y etiquetas
Envía un render del producto y cámbiale la etiqueta: cita el nombre de la marca y el claim breve, di sobre qué superficie van y usa negative_prompt contra los restos de letras de la etiqueta anterior.
Guía de prompts y consejos prácticos
Elige la forma de portada y quédate en 2k
Elige 3:4 o 2:3 para portadas y pósteres; la imagen se compone para esa forma y no se recorta dentro de ella. Deja la resolución en 2k para todo lo que lleve tipografía: la ventaja de este nivel desaparece en 1k.
Cita cada cadena y di dónde va
En una edición de texto, cita la cadena anterior y la nueva e indica la posición; luego di qué elementos deben quedar intactos, como la cabecera. Todo lo que la instrucción no menciona puede redibujarse.
Adapta el ejemplo incluido
Parte del ejemplo publicado con aspect_ratio: 3:4 y resolution: 2k. Cambia el sujeto y la dirección creativa, pero conserva el contrato de entrada de este modo.
Keep the portrait, wardrobe, lighting and grade exactly as they are. Change the cover line from 'THE LATE SHIFT' to 'AFTER HOURS' in the same small caps and the same position, and leave the masthead untouched.
Una edición de texto con una sola referencia: las dos cadenas citadas y la cabecera protegida de forma explícita. Aporta tu propia portada: el valor de image_urls es un marcador, no una muestra alojada.
Revisa el resultado antes de iterar
La combinación funciona cuando el prompt asigna un papel a cada referencia; con tres fuentes y sin papeles nombrados, el resultado es una mezcla que nadie pidió. Reescribir en su sitio requiere citar la cadena anterior y la nueva. Los rostros se desvían cuando reestilizas y reescribes en la misma llamada, así que sepáralo en dos pasadas.
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-3.0-pro/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.


















