Introducción
Qué hace este endpoint
Qwen Image 2.1 Pro Edición de imágenes revisa tus imágenes de origen según una instrucción escrita y devuelve de uno a seis encuadres nuevos con el nivel Pro alojado de Qwen Image 2.1 de Alibaba. Nuestras ediciones tardaron de 39 a 48 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, cada edición probada salió tal como se pidió, en los cinco niveles de intensidad, desde Suave hasta Máximo.
| 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 nivel Pro alojado de Alibaba |
| 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 a la imagen de origen en torno a 2K |
| Prompt | Hasta 5.000 caracteres; sin 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 de razonamiento opcional |
| Espera medida | De 14 a 43 segundos para texto a imagen y de 39 a 48 segundos para ediciones, en nuestras pruebas |
| Política de contenido | Sin censura: sin filtro de la plataforma ni indicador de madurez |
| Pesos | No publicados; Alibaba ofrece Pro como API alojada |
Funciones y aspectos destacados
Una cabecera bien escrita a la primera
Entrecomilla las palabras e indica dónde van. "AFTER DARK" en la parte superior y el pequeño titular de portada debajo salieron letra por letra, en las dos imágenes de la solicitud.
Dos retratos, una mesa a la luz de las velas
Un hombre y una mujer fotografiados por separado, nombrados como Image 1 e Image 2, acaban en una misma mesa en una terraza de viñedo, con ambos rostros aún reconocibles y el vestido de ella cambiado como se pidió.
Pro o Turbo, sin reescribir ni una línea
Pro y Turbo leen los mismos campos en SpicyAPI, así que un prompt que funciona en uno puede enviarse al otro sin cambios. Haz borradores rápidos en Turbo y guarda los encuadres que importan en Pro, o al revés.
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, así que tu instrucción llega al modelo tal como la escribiste. Activada, Alibaba la reescribe primero, lo que puede suavizar una solicitud más atrevida. 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.036 / imagen
Casos de uso
Trabajo de imagen sin censura
SpicyAPI no pone ningún filtro de contenido delante de Pro. Con la expansión de prompt desactivada, nuestras pruebas salieron tal como se escribieron en cada nivel de intensidad que probamos, desde Suave hasta Máximo, con sujetos femeninos y masculinos por igual.
Portadas y carteles con texto exacto
Alibaba destaca una tipografía mejorada en Pro. Entrecomilla la cabecera y el titular de portada, indica dónde va cada uno y describe la fotografía: nuestra portada de revista salió con ambas líneas escritas exactamente, en las dos imágenes de la solicitud.
Un mismo personaje en toda una serie
Genera un personaje, envía el encuadre de vuelta como referencia y cambia el atuendo, la habitación o la luz en pasadas separadas. Cada edición parte de tu encuadre aprobado en lugar 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 acabaron en una misma mesa a la luz de las velas en una terraza de viñedo, ambos aún reconocibles.
Retratos con atmósfera e iluminación
Alibaba señala la iluminación de retratos y el detalle fino como los puntos fuertes de Pro. Nombra una sola fuente de luz y dónde cae, un farol de tormenta, una ventana alta, una aplique, y el encuadre se construye a su alrededor.
Muchos borradores antes de uno definitivo
Hasta seis imágenes por llamada a un precio fijo hacen un abanico barato de opciones. Explora vestuario, pose y luz en una sola solicitud, quédate con el encuadre que funcione y dedica tus ediciones a ese.
Guía de prompts y consejos prácticos
Deja la expansión de prompt desactivada cuando importe la redacción
La expansión entrega tu prompt al reescritor de Alibaba antes de dibujar la imagen, y esa reescritura puede suavizar una solicitud atrevida. Aquí viene desactivada por defecto, y todas las pruebas de contenido que hicimos con ella desactivada salieron tal como se escribieron. En nuestra única prueba Pro con la expansión activada, un prompt que la app oficial bloquearía sí pasó, pero déjala desactivada siempre que la redacción exacta importe.
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 opción sensata. Baja a 1k solo cuando quieras un archivo más pequeño o una respuesta algo más rápida.
Pide varias imágenes a la vez
Fija
num_outputsde 1 a 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 económica 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 primero lo único que cambia y luego todo lo que debe mantenerse: «Cambia su vestido de terciopelo por un vestido de noche marfil; mantén su rostro, su pelo y su expresión». Nombra las referencias por número. En nuestra prueba con dos retratos, «el hombre de la imagen 1 y la mujer de la imagen 2» en una mesa iluminada con velas mantuvieron ambos rostros reconocibles en un mismo encuadre.
Entrecomilla las palabras que deben aparecer
Pon la redacción exacta entre comillas e indica dónde va. Nuestra portada de revista, con "AFTER DARK" arriba y "THE SILK ISSUE · NO. 07" en letra pequeña debajo, salió letra por letra. Mantén cada línea corta y compruébala 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 de aceite a la izquierda, un haz giratorio detrás de ella) en lugar de una palabra de ambiente. Con la expansión desactivada, Pro dibuja lo que escribes y no rellena los huecos por ti.
Introducción
Qwen Image 2.1 Pro Edición de imágenes cambia una imagen existente a partir de una instrucción en lenguaje llano. Pro es el nivel alojado de Qwen Image 2.1 de Alibaba, que unifica generación y edición en un solo modelo; Alibaba destaca la edición con hasta diez referencias, las ediciones locales que mantienen intactos a las personas y los productos, y una iluminación de retratos y un detalle fino mejorados.
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 Pro 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 Pro Edición de imágenes |
| Un encargo escrito y nada más | Qwen Image 2.1 Pro Texto a imagen |
Lo que medimos
Velocidad
De 39 a 48 segundos por edición de extremo a extremo en nuestras pruebas, incluidos dos resultados a partir de dos referencias en una sola llamada.
Forma
Sin relación de aspecto, un retrato 2:3 volvió como un encuadre 2:3 en torno a 2K (1664 × 2496). Fija una relación de aspecto cuando necesites un tamaño concreto.
Contenido
Con la expansión de prompt desactivada, que es lo predeterminado, cada edición probada salió como se pidió, en los cinco niveles de intensidad, desde Suave hasta Máximo. Ni una sola edición fue rechazada.
Dos referencias
Un hombre y una mujer fotografiados por separado volvieron uno junto al otro en una misma mesa a la luz de las velas, ambos reconocibles, con el atuendo de ella cambiado como se pidió.
Edición con Pro o con Turbo
| Pro | Turbo | |
|---|---|---|
| Qué es | Nivel Pro alojado de Alibaba | Checkpoint de 8 pasos |
| Pesos | No publicados | Abiertos, Qwen Research License |
| Resultados por solicitud | De 1 a 6 | De 1 a 6 |
| Precio por referencia adicional | Ninguno | Ninguno |
| Precio por imagen | Más alto | Más bajo |
| Filtro de contenido | Ninguno | Ninguno |
La solicitud es la misma, así que puedes ejecutar una misma instrucción en ambos y quedarte con el resultado que prefieras.
Guía de prompts y consejos Pro
Primero el cambio, después lo que se conserva
«Cambia su vestido de terciopelo por un vestido de noche marfil; mantén su rostro, su pelo y su expresión» es una edición. «Hazlo mejor» es un nuevo intento.
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 suavizar tu instrucción antes de que el modelo la vea. 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-pro/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.
