Ir al contenido principal

Sin censura — Este modelo declara que no aplica filtros. SpicyAPI reenvía sin añadir análisis de contenido de la plataforma; las obligaciones legales y de consentimiento siguen siendo del cliente.Ver todos los modelos con este nivel de filtrado
alibaba/qwen-image-2.1/edit

La edición de imágenes de Qwen Image 2.1 retoca de una a diez imágenes de referencia desde una instrucción escrita y devuelve un cuadro a 1k, 1.5k o 2k. También hace ediciones locales con una máscara en blanco y negro, donde el blanco se repinta.

Desde $0.036/imagen
Ejecutar modelo

Playground

Enviar una solicitud

Inicio rápido

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY
Qwen Image 2.1 · Image Editing · Resultado de ejemplo
Resultado de ejemploUsar este ejemplo
# 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/edit",
  "input": {
    "aspect_ratio": "1:1",
    "background": "opaque",
    "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"

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Parámetros de entrada

Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.

image_urlsarray<string>ObligatorioAfecta al precio

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: cuál es la persona, cuál el escenario, cuál la prenda. Cada referencia que agregas sube la estimación, así que manda solo las que están trabajando.

Valor predeterminado
Sin especificar
Restricciones
minItems:1
maxItems:10
promptstringObligatorio

Hasta 5,000 caracteres. Esta familia no tiene prompt negativo, así que las exclusiones también van aquí: nombra qué hay en el encuadre y después di con todas las letras qué no debe haber. Una descripción continua rinde más que una pila de palabras sueltas.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
maxLength:5000
seedintegerOpcional

Estabiliza la tirada para que una serie se quede en el mismo vecindario. No es una garantía de reproducción: mandamos el mismo prompt y el mismo seed dos veces y obtuvimos dos tomas distintas. Guarda el recurso devuelto cuando necesites otra vez esa imagen exacta.

Valor predeterminado
Sin especificar
Restricciones
minimum:0
maximum:2147483647
output_formatstringOpcional

JPEG por defecto. PNG cuando la toma entra a un paso de composición, WebP cuando sale directo a una página. El contenedor no cambia el precio ni el render.

Valor predeterminado
"jpeg"
Valores permitidos
"jpeg""png""webp"
backgroundstringOpcional

opaque por defecto. transparent devuelve solo el sujeto sobre un canal alfa real: combínalo con salida png o webp (jpeg no tiene canal alfa y la solicitud se rechaza) y describe solo el sujeto, porque nombrar una habitación, una superficie o una escena puede devolver un fondo. Disponible en 1k y 2k, no en 1.5k. No cambia el precio. No se puede combinar con mask_url.

Valor predeterminado
"opaque"
Valores permitidos
"opaque""transparent"
enable_prompt_expansionbooleanOpcional

Activado por defecto: antes de generar, el prompt se reescribe como una descripción de escena más completa. Desactívalo para que se use tu redacción tal cual. Desactivarlo está disponible en 1k y 2k, no en 1.5k. No cambia el precio. No tiene efecto cuando se envía mask_url.

Valor predeterminado
true
resolutionstringOpcionalAfecta al precio

El nivel que fija el tamaño de salida y el precio: 1k es el valor por defecto y el más barato, 1.5k queda en medio y 2k es donde la textura de la piel, el cabello y el tejido de la tela se sostienen. Itera en 1k y asciende a 2k la que vale la pena.

Valor predeterminado
"1k"
Valores permitidos
"1k""1.5k""2k"
aspect_ratiostringOpcional

Compone el encuadre antes de generar en lugar de recortarlo después, así que elige la forma en la que vas a publicar. Quince opciones, desde las franjas 3:1 y 21:9 hasta las columnas 1:3 y 9:21. Todas las relaciones cuestan lo mismo.

Valor predeterminado
"1:1"
Valores permitidos
"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"
mask_urlstringOpcional

Imagen opcional en blanco y negro que pasa la edición a modo local: el blanco marca la zona que se vuelve a pintar, el negro se conserva tal cual y unos pocos píxeles de borde suave ayudan a integrar el cambio. Úsala con exactamente una imagen de referencia de la misma proporción (una máscara de otro tamaño se ajusta) y describe en el prompt qué debe aparecer en la zona blanca. La salida conserva la forma de la imagen de referencia, así que aspect_ratio se ignora, y no se puede combinar con un fondo transparente. Disponible en 1k y 2k, no en 1.5k. No cambia el precio.

Valor predeterminado
Sin especificar
Restricciones
format:"uri"
contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

Seguir la tarea

HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.

Solicitud aceptada
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

La respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.

Consultar la tarea
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.

O recibe el resultado por callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.

Leer el resultado

Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.

Ejemplo de respuesta completada
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "alibaba/qwen-image-2.1/edit",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.png",
          "mime": "image/png",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.png?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Comandos de terminal y scripts de automatización.
MCP
Claude Code · Cursor · Codex
Agent Skill
Instrucciones reutilizables para tu asistente de IA.
n8n
Nodos comunitarios para instalaciones propias y plantillas HTTP Request importables para n8n Cloud.
ComfyUI
Flujos de imagen, video y audio en un lienzo de nodos.

Más integraciones

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Explorar flujos listos para usar

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca Qwen Image 2.1 · Image Editing en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Ejemplos de workflowsGuía de configuraciónCódigo en GitHub