Alibaba

Qwen Image 3.0

qwen-image-3.0/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/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/image-to-image per image

Precio unitario	$0.0358

Descripción general

Modelo de edición de imágenes basado en la modificación iterativa a partir de imágenes de referencia, perteneciente a la serie Qwen-Image 3.0. Al invocarlo, basta con pasar de 1 a 3 imágenes de referencia y un prompt positivo que describa el contenido que debe conservarse y modificarse para cambiar la escena, el estilo, la vestimenta y el texto de la imagen conservando los detalles clave de la imagen original, y generar imágenes en 1K o 2K. Es adecuado para desarrolladores que necesitan transformar rápidamente material existente en infografías, carteles, bocetos conceptuales de UI o imágenes de exhibición de productos, especialmente en escenarios de producción de contenido con alta densidad de texto en la imagen y altos requisitos de composición tipográfica multilingüe.

Puntos clave

Edición iterativa con imágenes de referencia que conserva los detalles originales: toma de 1 a 3 imágenes como entrada y modifica la escena, el estilo, la vestimenta y el texto según el prompt, en lugar de volver a dibujar por completo, lo que facilita iterar repetidamente sobre un mismo material.
Composición densa y renderizado de texto de cuerpo pequeño: diseñado para imágenes que transportan información, ofrece una composición tipográfica y un renderizado de texto multilingüe más estables, ideal para infografías, bocetos de interfaz y otros resultados con alta densidad de texto.
El prompt puede describir diseños complejos: el prompt positivo admite hasta 18000 caracteres, suficiente para describir imágenes con múltiples elementos, estructuras de maquetación y requisitos de modificación por zonas.
Especificaciones de salida controlables: admite niveles de resolución 1K/2K, 8 relaciones de aspecto, salida en png o jpeg, semilla aleatoria y prompt negativo, lo que facilita integrar los resultados en el flujo de producción.

Capacidades

Edición con imágenes de referencia: permite pasar de 1 a 3 imágenes de referencia junto con un prompt para modificar el contenido conservando la información clave de la imagen original, adecuado para realizar modificaciones dirigidas sobre material existente en lugar de regenerarlo.

Prompts largos y restricciones negativas: el prompt positivo admite descripciones extensas de la maquetación y de las zonas que deben conservarse o modificarse; además, el prompt negativo permite excluir elementos no deseados para un control preciso de la imagen.

Composición tipográfica y renderizado de texto: puede generar imágenes con una maquetación correcta e incluir texto multilingüe, adaptándose a la producción de contenido visual con alta densidad de texto, como infografías y bocetos conceptuales de interfaz.

Optimización automática del prompt: prompt_extend está activado de forma predeterminada y puede ampliar automáticamente el prompt, lo que reduce la carga de descripción cuando la entrada es breve; también puede desactivarse para mantener la entrada tal cual.

Especificaciones de salida y reproducibilidad: permite especificar el nivel de resolución, la relación de aspecto y el formato de archivo, y reproducir resultados mediante seed, lo que facilita la producción por lotes de material con un estilo consistente.

Casos de uso

Diseñadores que renuevan carteles o infografías existentes: sube el cartel o la maqueta original y ajusta el texto, el estilo o la composición según el prompt para obtener una versión actualizada del material visual lista para su publicación.
Equipos de producto que iteran bocetos conceptuales de UI: usa capturas de pantalla de la interfaz actual como imágenes de referencia, modifica la paleta de colores, la maquetación o el texto y genera imágenes conceptuales de interfaz de alta fidelidad para revisiones y debates de prototipos.
Operaciones de comercio electrónico que actualizan imágenes de exhibición de productos: usa imágenes de productos como referencia, ajusta la escena, el fondo o la vestimenta de los modelos y genera imágenes de exhibición de productos para páginas de detalle y material de marketing.
Localización de material multilingüe: usa material en chino o inglés como imagen de referencia, sustituye el idioma y el estilo y genera material visual promocional adaptado a diferentes mercados.

Limitaciones y recomendaciones de selección

Solo admite edición de imágenes y no tiene capacidad de texto a imagen; para generar imágenes a partir de texto puro debe elegirse la línea de texto a imagen de la misma serie. Las imágenes de referencia están limitadas a 1–3 y no deben superar los 10 MB cada una; tampoco se admite SVG, por lo que los escenarios de composición compleja con múltiples imágenes se ven limitados. La legibilidad del texto de cuerpo pequeño depende de la densidad de la composición tipográfica y del idioma, por lo que debe verificarse imagen por imagen antes de la entrega. Dado que el modelo es reciente, las evaluaciones independientes públicas son limitadas; se recomienda validar primero el resultado con unos pocos ejemplos y después integrarlo en flujos por lotes.

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/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria utilizada para controlar la aleatoriedad de los resultados generados; su forma de valor es un número entero; la misma semilla junto con los mismos demás parámetros permite reproducir resultados similares.

promptstringObligatoriominLength 1maxLength 18000

Indicación positiva, describe con texto el contenido que debe conservarse y modificarse; su forma de valor es una cadena de texto.

image_urlsarrayObligatoriominItems 1maxItems 3

Arreglo de URL de imágenes de referencia; los elementos son cadenas de texto con enlaces a imágenes, de 1 a 3; admite JPEG, PNG, WEBP, BMP, GIF, TIFF, cada una de no más de 10 MB; no admite SVG.

Array [ string ]

resolutionstringOpcionalPredeterminado: "1K"

Nivel de resolución de salida; su forma de valor es una cadena de texto, por defecto 1K.

Opciones:1K2K

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto (ancho/alto) de la imagen de salida; su forma de valor es una cadena de texto, por defecto 1:1.

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

output_formatstringOpcionalPredeterminado: "png"

Formato de archivo de la imagen generada; su forma de valor es una cadena de texto, por defecto png.

Opciones:pngjpeg

prompt_extendbooleanOpcionalPredeterminado: true

Indica si se optimiza automáticamente la indicación; su forma de valor es un valor booleano, por defecto true.

negative_promptstringOpcionalPredeterminado: ""maxLength 500

Contenido que no se desea que aparezca en la imagen; su forma de valor es una cadena de texto, por defecto una 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/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/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/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"
    }
  }
}