Alibaba

Qwen Image 3.0

qwen-image-3.0-pro/image-to-image

Modelo de generación y edición de imágenes de tercera generación de Alibaba, especializado en maquetación densa y renderizado de texto multilingüe con prompts largos, y compatible con la edición mediante imágenes de referencia

qwen-image-3.0-pro/image-to-image qwen-image-3.0-pro/text-to-image qwen-image-3.0/image-to-image qwen-image-3.0/text-to-image

Probar qwen-image-3.0-pro/image-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

qwen-image-3.0-pro/image-to-image per image

Especificaciones	Precio unitario
1K	$0.0497
2K	$0.0993

Descripción general

La línea de edición de imágenes de Qwen Image 3.0 Pro permite realizar modificaciones controladas sobre la imagen a partir de 1–3 imágenes de referencia, con especial atención a conservar los detalles clave de la imagen original mientras se sustituyen la escena, el estilo, la ropa o el texto de la imagen. Está pensada para equipos de diseño, comercio electrónico y contenido que necesitan iterar repetidamente sobre un mismo material; mediante la interfaz unificada de HiAPI.ai, basta con describir en el prompt qué conservar y qué modificar para obtener la imagen final, lo que la hace idónea para transformar activos visuales existentes en materiales de múltiples versiones.

Puntos clave

Iteración sobre imágenes de referencia en lugar de redibujado: toma 1–3 imágenes de referencia como base de entrada y modifica el contenido indicado preservando los detalles clave de la imagen original.
Orientado a imágenes con gran carga informativa: el prompt puede describir contenido denso como la maquetación, los elementos y el texto, generando resultados más cercanos a entregables de trabajo reales.
Especificaciones de salida controlables: la resolución, la relación de aspecto, el formato de salida y la semilla aleatoria se pueden especificar, lo que facilita producir lotes de material con especificaciones uniformes.

Capacidades

Edición con múltiples imágenes de referencia: acepta de 1 a 3 imágenes de referencia en formatos habituales como JPEG, PNG, WEBP, BMP, GIF y TIFF, con un máximo de 10 MB por imagen, y permite modificaciones dirigidas de escena, estilo y ropa.

Descripción de los cambios mediante prompts largos: el prompt positivo admite hasta 18000 caracteres y puede especificar por separado las partes que deben conservarse y las que deben cambiarse; el prompt negativo controla de forma independiente el contenido que no se desea que aparezca.

Ajuste de maquetación y texto: orientado a imágenes con alta densidad de elementos, permite ajustar la disposición y el contenido textual durante la edición, lo que resulta adecuado para convertir carteles, bocetos de interfaz o imágenes de producto existentes en nuevas versiones.

Control de las especificaciones de salida: permite elegir resolución de 1K o 2K, ocho relaciones de aspecto y formatos de salida png y jpeg, además de fijar la semilla para reproducir resultados.

Optimización automática del prompt: la expansión del prompt está activada por defecto y puede completar detalles descriptivos cuando el prompt es breve; también puede desactivarse para ejecutar exactamente el texto original.

Casos de uso

Equipos de diseño que renuevan carteles y banners: se introduce la maquetación existente junto con las indicaciones de cambio y se obtiene una nueva versión con proporciones y textos actualizados, lista para publicidad y sustitución de materiales.
Operaciones de comercio electrónico que transforman imágenes de producto: usando la imagen de producto existente como referencia, se sustituyen el fondo, la escena o la ropa del modelo para producir varios conjuntos de imágenes de presentación destinadas a páginas de detalle y páginas de campaña.
Iteración de bocetos conceptuales de UI: se introduce un boceto de interfaz o un diseño existente y se modifica la disposición y la presentación de los controles según el prompt, como prototipo de alta fidelidad para debatir propuestas.
Localización de materiales multilingües: a partir de una misma imagen de material original se sustituyen el texto y el idioma de la imagen para producir en lote versiones para distintos mercados destinadas a campañas localizadas.

Limitaciones y recomendaciones de selección

Se admiten como máximo 3 imágenes de referencia, lo que limita los escenarios de composición compleja con muchas imágenes; no se admite la entrada SVG y cada imagen de referencia no puede superar los 10 MB. La legibilidad de la maquetación y del texto depende de la densidad de composición y del idioma, por lo que los textos pequeños y densos requieren una revisión por muestreo. Esta línea solo realiza imagen a imagen; si solo se necesita generar una imagen a partir de texto, conviene usar la línea de texto a imagen de la misma serie. Para tareas por lotes con altos requisitos de estabilidad de los resultados, se recomienda fijar la semilla y conservar las versiones del prompt para poder reproducirlos.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo disponible: qwen-image-3.0-pro/text-to-image Oct 31, 2026
Nuevo modelo Lanzamiento del modelo de imagen a imagen qwen-image-3.0-pro Oct 31, 2026
Nuevo modelo Se añaden qwen-image-3.0/text-to-image… Aug 20, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Cuántas imágenes de referencia admite la edición de imágenes de Qwen Image 3.0?

Admite de 1 a 3 imágenes de referencia. Se requiere al menos una; el campo de la API es input.image_urls.
¿Cuál es la diferencia entre la edición de imágenes de la versión estándar y la Pro?

La versión estándar prioriza un menor costo y una iteración rápida; la Pro es más adecuada para el reemplazo preciso de texto, materiales complejos y el diseño final.
¿Cómo se facturan 1K, 2K y las imágenes de referencia?

1K y 2K utilizan el mismo nivel de salida, y cada imagen de referencia tiene un cargo adicional; el importe concreto se rige por el precio en tiempo real de esta página.
¿Cómo reducir la deriva del sujeto, el diseño o el texto?

En el Prompt, enumera por separado el contenido que se va a cambiar y el sujeto, el texto, la posición, los materiales, el encuadre y la iluminación que deben conservarse; cuando necesites texto exacto, escribe el texto objetivo entre comillas.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: qwen-image-3.0-pro/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para qwen-image-3.0-pro/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria para controlar la aleatoriedad de los resultados de generación; con la misma semilla y los demás parámetros idénticos, se pueden reproducir resultados de imagen similares.

promptstringObligatoriominLength 1maxLength 18000

Prompt positivo que describe el contenido de la imagen que se desea conservar y el que se necesita cambiar; es la entrada guía principal de la generación de imagen a imagen.

image_urlsarrayObligatoriominItems 1maxItems 3

Array de URL de imágenes de referencia que controla las imágenes de entrada en las que se basa la generación de imagen a imagen; se deben proporcionar de 1 a 3, compatible con formatos JPEG, PNG, WEBP, BMP, GIF y TIFF, cada una con un máximo de 10 MB; no se admite SVG.

Array [ string ]

resolutionstringOpcionalPredeterminado: "1K"

Nivel de resolución de salida que controla el grado de nitidez de la imagen generada; por defecto 1K.

Opciones:1K2K

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto del encuadre de salida que controla las dimensiones de composición de la imagen generada; por defecto 1:1.

Opciones:1:13:22:34:33:416:99:1621:9

output_formatstringOpcionalPredeterminado: "png"

Formato de archivo de la imagen generada que controla el tipo de archivo del resultado devuelto; por defecto png.

Opciones:pngjpeg

prompt_extendbooleanOpcionalPredeterminado: true

Indica si se optimiza automáticamente el prompt; al activarse, el modelo amplía y pule el prompt de entrada; por defecto true.

negative_promptstringOpcionalPredeterminado: ""maxLength 500

Prompt negativo que describe el contenido que no se desea que aparezca en la imagen; por defecto cadena vacía.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0-pro/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-image-3.0-pro/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "qwen-image-3.0-pro/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1",
          "output_format": "png",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}