Qwen Image 3.0 API

Qwen Image 3.0 Edición de imagen recibe de una a tres imágenes de referencia y una instrucción, y devuelve un resultado editado. Con una sola referencia es una edición puntual; con dos o tres, combina —un rostro de una, una prenda o un fondo de otra—, siempre que el prompt diga qué aporta cada una.

Qwen Image 3.0 es el modelo de imagen de Alibaba especializado en renderizar texto: prompts de 5.000 caracteres, ocho proporciones, un nivel de 1K o 2K y un endpoint de edición que lee de una a tres referencias. Sin censura y sin marcas que activar.

Elige un modo de Qwen Image 3.0 según tu material de partida

Composición de imagen pensada para el texto

Qwen Image 3.0 es útil para conceptos visuales en los que el texto aportado, la composición y el tratamiento de la imagen deben considerarse juntos. Trata las letras generadas como un borrador de diseño y revísalas antes de publicar.

Componer desde cero y revisar una fuente son trabajos distintos

Usa texto a imagen para levantar una imagen a partir de un brief escrito. Usa la edición de imagen cuando una imagen existente aporta la identidad, la composición o el material que hay que conservar mientras se hace un cambio concreto.

Revisa la jerarquía antes que el detalle decorativo

En pósteres, envases y conceptos de campaña, decide primero la jerarquía del mensaje y el punto focal. Un resultado atractivo sigue sin cumplir el encargo si el texto aprobado o los datos del producto no aparecen correctamente.

Pulir una imagen que ya tienes

Usa este modo cuando de una a tres imágenes existentes deban fijar el sujeto, la composición o el material. Ponlas en image_urls en el orden en que tu prompt las nombra —primera, segunda, tercera— y di qué aporta cada una.

Sets de personajes y series de moda

Conserva el personaje de una imagen aprobada y cambia un detalle por solicitud: vestuario, luz o pose. Fija seed cuando compares dos redacciones del mismo cambio, para que no sea la tirada lo que se movió.

Variantes con el texto localizado

Envía la imagen aprobada al endpoint de edición y cambia solo las palabras del letrero. La pose, el vestuario, la luz y el etalonaje se describen como sin cambios, así que la variante se diferencia en el texto y no en toda la imagen.

Escenografías de hotelería y ambientación

Envía una imagen aprobada de una habitación o un bar y añade o sustituye la señalética: un colgador de puerta, una pizarra de menú, una línea de neón. Cita el texto nuevo y, si ya existe un letrero, cita también la cadena anterior.

# 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-3.0/edit",
  "input": {
    "aspect_ratio": "1:1",
    "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.