Introducción
Qwen Image 2.1 LoRA Edición aplica tus propios pesos LoRA mientras revisa de una a diez imágenes de referencia. Es el mismo montaje de pesos propios que el endpoint de texto a imagen, apuntado a trabajo que ya tienes en vez de a una toma en blanco.
No hay revisión de los pesos que cargas ni filtro de contenido sobre el resultado.
Elige un modo de Qwen Image 2.1 LoRA según tu material de partida
| Material de partida | Modo |
|---|---|
| Imágenes de origen más tus propios pesos | Qwen Image 2.1 LoRA Edición de imagen |
| Un encargo más tus propios pesos | Qwen Image 2.1 LoRA Texto a imagen |
| Editar sin pesos propios | Qwen Image 2.1 Edición de imagen |
Funciones y aspectos destacados
Lleva un LoRA de personaje a trabajo que ya está en marcha
Un LoRA con el que solo puedes empezar trabajo nuevo sirve mucho menos que uno que puedes aplicar a una toma aprobada. Este endpoint acepta las dos cosas: hasta diez referencias y hasta tres archivos de pesos en la misma solicitud.
Pesos y referencias resuelven mitades distintas de la consistencia
Las referencias sostienen la composición, el escenario y la toma concreta; el LoRA sostiene la identidad en todas las tomas. Usar los dos es más estable que apoyarse fuerte en cualquiera de ellos.
Sin censura de los dos lados
Sin revisión de los pesos, sin filtro sobre la salida, y una fuente se queda como está a menos que la instrucción diga otra cosa.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5,000 caracteres. Esta familia no tiene prompt negativo, así que las exclusiones también van aquí. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De una a diez imágenes de referencia. El modelo no asigna papeles por su cuenta, así que nombra en el prompt qué aporta cada fuente. mínimo 1 elementos · máximo 10 elementos |
aspect_ratio | No | Compone el encuadre antes de generar en lugar de recortarlo después. Quince opciones, desde las franjas 3:1 y 21:9 hasta las columnas 1:3 y 9:21. |
resolution | No | Fija el tamaño de salida y el precio: 1k por defecto, 1.5k en medio y 2k donde la textura de la piel y la tela se sostienen. Itera en 1k y asciende a 2k la que vale la pena. |
loras | No | Hasta tres archivos de pesos, cada uno {path, scale}. Valor predeterminado: |
output_format | No | JPEG por defecto; PNG para composición y WebP para salir directo a una página. No cambia el precio ni el render. |
seed | No | Estabiliza la tirada para que una serie se quede en el mismo vecindario. |
Precios
| Especificación | Precio |
|---|---|
| $0.042 / imagen |
| $0.078 / imagen |
| $0.15 / imagen |
Casos de uso
Aplicar un LoRA de personaje a tomas que ya aprobaste
Lo caro de una sesión rara vez es la generación: es llegar a una toma que todo el mundo firmó. Este endpoint te deja conservar esa toma y cambiar quién aparece en ella: manda la composición aprobada como referencia, carga el LoRA de personaje y deja que los pesos lleven la identidad mientras la iluminación, la puesta en escena y el encuadre se quedan exactamente donde estaban.
Traer un catálogo viejo al estilo actual de la casa
Apunta un LoRA de estilo a trabajo generado hace meses. Manda las tomas viejas como referencias, carga los pesos de estilo a un scale moderado y vuelve a correrlas para que una toma de archivo y una nueva convivan en la misma página sin una costura evidente entre ellas.
Escena adulta armada a partir de una referencia que tú controlas
Parte de una figura que ya generaste y agrega el segundo sujeto, el vestuario, la sujeción o el escenario. Las instrucciones se ejecutan tal como están escritas y los pesos sin censura cargan sin revisión, así que la escena se puede armar por pasos en vez de jugártela en un solo prompt.
Cambios de vestuario y de locación con la persona fija
Dos referencias —una que trae a la persona, otra que trae la prenda o la habitación— más un LoRA de personaje, y un prompt que diga cuál es cuál. Cambia la habitación y conserva la cara; cambia el conjunto de ropa y conserva las dos cosas.
Guía de prompts y consejos prácticos
Nombra qué aporta cada referencia antes de nombrar el cambio
El modelo no deduce los papeles por el orden ni por el nombre del archivo. Escríbelo: "la primera imagen es la mujer, la segunda es la habitación en la que está parada, la tercera es el abrigo". Sin esa frase, una solicitud con varias referencias mezcla las fuentes en vez de editar con ellas, y el resultado parece un artefacto de promediado más que un error que puedas depurar.
No dejes que el prompt y el LoRA describan lo mismo
Cuando hay un LoRA de personaje cargado, describe la escena, la acción y la luz, no la cara. Repetir rasgos que los pesos ya codifican jala el render en dos direcciones y suele producir algo que no se parece a ninguna. Deja que el LoRA sea dueño de la identidad y que el prompt sea dueño de todo lo que la rodea.
Pon las protecciones en la instrucción, porque no hay prompt negativo
Declara con todas las letras qué debe sobrevivir a la edición: "mantenla exactamente como en la fuente, sin añadir nada a su vestuario" o "no cambies el largo del cabello". Un modelo de edición librado a su propio criterio va a ordenar cosas que no pediste que ordenara, y en el trabajo adulto ese ordenar es todo el modo de fallo.
Ponle precio a la solicitud antes de enviarla, no después
Aquí hay dos cosas moviendo el costo a la vez: la cantidad de referencias y el nivel de resolución, con el recargo del LoRA encima. Diez referencias con tres LoRA en 2k es la forma más cara que acepta esta familia. La estimación previa al envío manda: léela en las solicitudes grandes en vez de suponer que el nivel por sí solo fija el precio.
Verifica que un LoRA nuevo cambia algo antes de confiarle una tanda
Los pesos hechos para otra arquitectura base pueden cargar sin error y no tener casi ningún efecto visible. Corre un prompt deliberadamente evidente contra los pesos nuevos, confirma que la salida se movió y recién entonces encola la tanda.
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-lora/edit",
"input": {
"aspect_ratio": "1:1",
"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.
