Introducción
Qué hace este endpoint
Qwen Image 2.1 Turbo Edición de imágenes revisa tus imágenes de origen según una instrucción escrita y devuelve de uno a seis fotogramas nuevos con el checkpoint de 8 pasos de Qwen Image 2.1 de Alibaba. Nuestras ediciones tardaron de 26 a 59 segundos de extremo a extremo.
Entradas
image_urls lleva de una a diez referencias, en el orden en que las nombras Image 1, Image 2, etcétera. prompt es la instrucción. Omite aspect_ratio para conservar la forma de la imagen de origen en torno a 2K, o fíjalo junto con resolution para un tamaño concreto. num_outputs pide de uno a seis resultados, enable_prompt_expansion (desactivada por defecto) y enable_thinking controlan la reescritura de Alibaba, y seed estabiliza una serie.
Contenido
Sin filtro de la plataforma. Con la expansión desactivada, las ediciones que cambian la ropa o muestran más salieron como se pidieron; con ella activada, la misma instrucción volvió sin cambios.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Estado en SpicyAPI | Activo: texto a imagen y edición de imágenes |
| Basado en | Qwen Image 2.1, como checkpoint acelerado de 8 pasos del mismo modelo de 7B |
| Imágenes por solicitud | De 1 a 6, facturadas por imagen devuelta |
| Precio | Un precio fijo por imagen en los niveles 1k, 1.5k y 2k; la cotización en vivo está en esta página |
| Relaciones de aspecto | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Tamaños en 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Edición | De 1 a 10 imágenes de referencia; sin relación de aspecto, la salida sigue la imagen de origen en torno a 2K |
| Prompt | Hasta 5.000 caracteres; no hay prompt negativo, así que escribe las exclusiones dentro del prompt |
| Expansión de prompt | Desactivada por defecto; reescritura direct o agent cuando está activada, con una pasada opcional de razonamiento |
| Espera medida | De 13 a 39 segundos para texto a imagen y de 26 a 59 segundos para ediciones, en nuestras pruebas |
| Política de contenido | Sin censura: sin filtro de la plataforma y sin indicador de madurez |
| Pesos abiertos | Qwen/Qwen-Image-2.1-Turbo bajo la Qwen Research License Agreement |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | La instrucción de edición, hasta 5.000 caracteres. Indica primero qué cambia y después qué debe quedar igual: cara, pelo, pose, luz. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De una a diez imágenes de origen, en el orden en que las nombras. El número de referencias no cambia el precio. mínimo 1 elementos · máximo 10 elementos |
aspect_ratio | No | Si lo omites, el resultado conserva la forma de tu imagen de origen en torno a 2K. |
resolution | No | 1k, 1.5k o 2k, y solo se usa cuando fijas una relación de aspecto. Todos los niveles cuestan lo mismo por imagen. |
num_outputs | No | De uno a seis resultados de la misma instrucción en una sola solicitud. Cada imagen devuelta se factura. |
enable_prompt_expansion | No | Desactivada por defecto. Valor predeterminado: |
enable_thinking | No | Dedica razonamiento extra a la reescritura, a costa de una espera más larga. Solo funciona mientras la expansión de prompt está activada. Valor predeterminado: |
seed | No | Estabiliza una tirada para que puedas comparar un cambio cada vez. No garantiza una imagen idéntica píxel a píxel. |
Precios
$0.014 / imagen
Casos de uso
Trabajo de imagen sin censura
SpicyAPI no coloca ningún filtro de contenido delante de Turbo. Con la expansión de prompts desactivada, nuestras pruebas salieron tal como estaban escritas en cada nivel de contenido que ejecutamos, de Suave a Máximo, tanto para mujeres como para hombres. En el nivel Muy fuerte pasó una de dos ejecuciones; la otra se detuvo antes de completar la solicitud.
Muchos borradores antes de uno bueno
Ocho pasos y hasta seis imágenes por llamada dan un abanico barato de opciones. Explora vestuario, pose y luz en una sola solicitud, quédate con el encuadre que funciona y gasta tus ediciones en ese.
Un personaje a lo largo de una serie
Genera un personaje, devuelve el encuadre como referencia y cambia el vestido, la habitación o la luz en pasadas separadas. Cada edición parte de tu encuadre aprobado y no de una tirada nueva, así que el rostro se mantiene en toda la serie.
Parejas a partir de dos retratos
Envía dos retratos como Image 1 e Image 2 y describe la escena que comparten. En nuestra prueba, un hombre y una mujer fotografiados por separado terminaron riendo uno junto al otro en una azotea al atardecer, ambos todavía reconocibles.
Carteles y tipografía
Turbo resuelve con limpieza titulares cortos. Entrecomilla la redacción, indica dónde va y describe el estilo del cartel: nuestro cartel de cabaret salió con las dos líneas escritas exactamente.
Fotos de producto y portadas
El precio fijo hasta 2K y las seis imágenes por llamada van bien para miniaturas, portadas y fotos de producto, donde quieres varios recortes de una misma idea y un máster a tamaño completo que puedas reducir.
Guía de prompts y consejos prácticos
Deja la expansión de prompt desactivada para trabajo adulto
La expansión entrega tu prompt al reescritor de Alibaba antes de dibujar la imagen, y el reescritor modera los briefs sin filtrar: en nuestras pruebas suavizó una imagen de nivel Fuerte, convirtió una escena de nivel Muy fuerte en una que solo la insinuaba y devolvió una edición que pedía ir más allá sin cambiar nada. Con la expansión desactivada, los mismos prompts salieron tal como se escribieron. Aquí viene desactivada por defecto; déjala así salvo que quieras la reescritura.
Actívala para prompts cortos de uso cotidiano
Un encargo de seis palabras obtiene una escena más completa con la expansión activada. direct reescribe en una sola pasada y sirve para la mayoría de los prompts; agent reescribe en varios pasos para un resultado más fino. El modo de razonamiento dedica razonamiento extra a esa reescritura y añade tiempo; no hace nada mientras la expansión está desactivada.
Usa 2K, cuesta lo mismo
Todos los niveles tienen el mismo precio por imagen, así que 2K es el valor por defecto y la elección sensata. Baja a 1k solo si quieres un archivo más pequeño o una respuesta algo más rápida.
Pide varias imágenes a la vez
Fija
num_outputsentre 1 y 6 para obtener variaciones de un mismo prompt en una sola llamada. Cada imagen devuelta se factura, así que seis imágenes cuestan seis veces una. Es la forma más barata de encontrar una pose o una composición que te guste antes de empezar a editar.Edita con el cambio primero y la lista de lo que se conserva después
Escribe lo único que cambia y luego todo lo que debe quedar: «Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression.» (cambia su vestido de terciopelo oscuro por un vestido de satén carmesí con la espalda descubierta; conserva su cara, su pelo y su expresión). Nombra las referencias por número. En nuestra prueba con dos retratos, «the man from Image 1 and the woman from Image 2» (el hombre de la Image 1 y la mujer de la Image 2) mantuvo reconocibles ambos rostros en un mismo encuadre.
Entrecomilla las palabras que deben aparecer
Pon la redacción exacta entre comillas e indica dónde va. Nuestro cartel de prueba, «VELVET HOUR» arriba y «LATE SHOW · FRIDAYS 11 PM» abajo, salió letra por letra. Mantén cada línea corta y revísala a tamaño completo antes de publicar.
Escribe el prompt en un orden fijo
Sujeto, vestuario, pose, luz, objetivo y paleta, en frases sencillas. Nombra la fuente de luz y su dirección (una lámpara cálida a la izquierda, un vidrio con rastros de lluvia a su espalda) en lugar de una palabra de ambiente. Con la expansión desactivada, Turbo dibuja lo que escribes y no rellena los huecos por ti.
Introducción
Qwen Image 2.1 Turbo Edición de imágenes cambia una imagen existente a partir de una instrucción en lenguaje llano. El equipo Qwen de Alibaba publicó Turbo con pesos abiertos el 9 de octubre de 2026 y lo diseñó para seguir creando mediante ediciones en lenguaje natural, desde añadir un accesorio hasta cambiar una escena, en 8 pasos de eliminación de ruido sobre la misma arquitectura de 7B que Qwen Image 2.1.
En SpicyAPI está activo. Una solicitud admite de una a diez referencias y devuelve de uno a seis resultados a un precio fijo por imagen, sin ningún filtro de contenido delante del modelo. Todos los ejemplos de esta página se generaron con Turbo y con el prompt que se muestra.
Elige un modo según lo que tengas
| Material de partida | Modo |
|---|---|
| Una o más imágenes que cambiar | Qwen Image 2.1 Turbo Edición de imágenes |
| Un encargo escrito y nada más | Qwen Image 2.1 Turbo Texto a imagen |
Lo que medimos
Velocidad
De 26 a 59 segundos por edición de extremo a extremo en nuestras pruebas.
Forma
Sin relación de aspecto, un retrato 2:3 volvió como un encuadre 2:3 en torno a 2K (1680 × 2512). Fija una relación de aspecto cuando necesites un tamaño concreto.
Contenido
Con la expansión de prompts desactivada, la opción predeterminada, las ediciones en cada nivel de contenido que probamos devolvieron lo pedido, en un retrato de mujer y otro de hombre. Con la expansión activada, la solicitud de ir más allá devolvió dos veces la fuente sin cambios y se cobró como completada.
Dos referencias
Un hombre y una mujer fotografiados por separado volvieron uno junto al otro en una misma azotea, ambos reconocibles, con el atuendo de ella cambiado como se pidió.
Edición con Turbo o con Qwen Image 2.1
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| Pasos de eliminación de ruido | 8 | 40 |
| Resultados por solicitud | De 1 a 6 | 1 |
| Precio por referencia adicional | Ninguno | Cada una suma al precio |
| Máscara para ediciones locales | No | Sí |
| Formato de salida | PNG | JPEG, PNG o WebP |
| Filtro de contenido | Ninguno | Ninguno |
Elige Turbo para cadenas rápidas de ediciones y trabajo con varias referencias a un precio fijo. Elige Qwen Image 2.1 cuando necesites una máscara.
Guía de prompts y consejos Pro
Primero el cambio, después lo que se conserva
«Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression» (cambia su vestido de terciopelo oscuro por un vestido de satén carmesí con la espalda descubierta; conserva su cara, su pelo y su expresión) es una edición. «Make it better» (hazlo mejor) es una nueva tirada.
Nombra cada referencia
El modelo no asigna papeles a las referencias por su cuenta. Indica qué imagen es la persona, cuál la prenda y cuál el lugar.
Deja la expansión desactivada
La reescritura puede descartar tu instrucción y devolver la imagen de origen. Desactivada, la instrucción llega al modelo tal como la escribiste.
Un cambio por pasada
Un solo cambio es fácil de juzgar. Cinco a la vez dificultan saber qué instrucción movió la cara o las manos.
Vuelve al original tras varias ediciones
Los rostros pueden desviarse a lo largo de una cadena larga de ediciones. Vuelve a tu primer encuadre aprobado cuando los detalles empiecen a moverse.
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-turbo/edit",
"input": {
"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.
