Introducción
Qwen Image Edit Spicy edita una sola imagen de origen con una única instrucción en inglés sencillo. No hay máscara, ni selector de zona, ni control de cuánto se aleja del original: la frase es todo el mando, y solo se protege lo que nombras.
La solicitud es image_url, prompt y un seed opcional; un seed de 0 pide una tirada aleatoria. Cada solicitud devuelve una imagen.
Funciones y aspectos destacados
Sin máscara, sin intensidad, sin flujo de inpainting
La mayoría de los editores te hacen elegir una zona y un grado de cambio antes de tocar nada. Este recibe una frase. Nombra lo que cambia, nombra lo que debe quedarse y envíala. Que no haya control de intensidad es deliberado: lo que se conserva se expresa con palabras, y así también puedes revisar una edición después.
Atrevidos cambios de vestuario, sin filtrar
Un cambio de vestuario que rechazan los editores con filtro es aquí una instrucción normal, no un caso especial. No hay indicador de madurez que activar ni otro endpoint al que se desvíe la solicitud. La redacción de la instrucción pasa tal como está escrita.
Reescribe un letrero sin redibujar la habitación
Como hereda la tipografía de la línea Qwen Image, puede cambiar un texto que ya está en la imagen: un colgador de puerta, una pizarra de menú, la etiqueta de una botella. Cita la cadena que hay y la que quieres, y deja claro que la pose, el encuadre y el etalonaje no se tocan.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | Un enlace público y descargable directo a una imagen sobre la que tengas derechos. mínimo 1 caracteres |
prompt | Sí | Una instrucción que carga las dos mitades de la edición. mínimo 1 caracteres |
seed | No | Manda la misma seed con la misma imagen y la misma instrucción para que el sorteo sea idéntico entre dos ediciones y lo único que cambie sea lo que tocaste; es una herramienta d… |
Precios
$0.038 / imagen
Casos de uso
Pulir una imagen que ya tienes
Usa este endpoint cuando una foto existente debe seguir siendo esa foto y solo tiene que cambiar una cosa. Envíala como image_url, nombra el cambio y los elementos que deben quedarse —pose, encuadre, luz, etalonaje— y compara el resultado con el original.
Instrucciones que otros editores rechazan
Las instrucciones atrevidas de vestuario que rechazan las API de edición con filtros se ejecutan aquí como ediciones normales. En la solicitud no cambia nada: los mismos nombres de campo, el mismo ciclo de vida de la tarea, la misma consulta asíncrona del resultado.
Cambios de vestuario sobre una imagen aprobada
Ya tienes un retrato cuya pose y luz funcionan. Cambia el atuendo por ropa de noche o un look más atrevido sin regenerar la escena, de modo que el rostro, la habitación y la gradación sobrevivan al cambio y el conjunto se mantenga coherente.
Variantes de texto sobre una foto que ya pagaste
Cambia solo las palabras de un letrero, un colgador o una etiqueta y deja la fotografía idéntica. Es más barato y mucho más coherente que regenerar toda la escena para cada idioma o cada línea de campaña.
Guía de prompts y consejos prácticos
Aloja la imagen de origen en un sitio accesible
image_url tiene que ser un enlace público de descarga directa: ni una página de visor ni una URL firmada que caduque antes de que corra la tarea. El original fija la composición y el techo de calidad de toda la pasada.
Escribe una instrucción que nombre los dos lados de la edición
Di qué cambia y qué debe quedar idéntico, con una frase para cada cosa. La edición de este endpoint salió de: «Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.»
Adapta el ejemplo incluido
Parte del ejemplo publicado, con una URL de acceso público en image_url. Cambia el sujeto y la dirección creativa, pero conserva el contrato de entrada de este modo.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
La instrucción exacta detrás de la edición mostrada para este endpoint: un cambio de atuendo más un cambio de texto en el colgador de la puerta, con la pose, el encuadre, la iluminación y la gradación nombrados expresamente como inalterados. Aporta tu propia imagen de origen: la image_url de aquí es un marcador, no una muestra alojada.
Revisa el resultado antes de iterar
El camino fiable es un cambio por llamada, nombrando de forma explícita lo que se conserva: pose, encuadre, luz, etalonaje. Si pides un cambio de vestuario y uno de texto en la misma instrucción, uno de los dos suele desviarse. La identidad se sostiene bien en una sola edición puntual y se degrada en cadenas largas, así que vuelve a editar desde el original y no desde el resultado anterior. No hay control de intensidad: si una edición se pasó, la solución es una frase más concreta, no un número más bajo.
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-spicy-edit/edit",
"input": {
"image_url": "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.
