Alibaba

Qwen Image 2.0

qwen-image-2.0-pro

Modelo de arquitectura unificada de generación y edición de imágenes de Alibaba, especializado en la renderización de textos largos en chino, compatible con instrucciones de hasta 1000 tokens y salida en 2K

qwen-image-2.0 qwen-image-2.0-pro

Probar qwen-image-2.0-pro

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

qwen-image-2.0-pro per image

Precio unitario	$0.107

Descripción general

Qwen Image 2.0 Pro es el modelo de texto a imagen de gama alta de la serie Qwen Image 2.0 de Alibaba, que se invoca a través de la interfaz unificada de HiAPI.ai. Está orientado a desarrolladores que necesitan imágenes comerciales de alta calidad, y destaca en el renderizado de texto en chino y en la comprensión de instrucciones extensas, con soporte de salida de hasta 2K de resolución. Es adecuado para escenarios de producción de contenido como carteles, presentaciones y cómics de formato largo, así como para flujos automatizados de generación de imágenes que requieren resultados reproducibles y restricciones negativas controlables.

Puntos clave

El renderizado de texto en chino es el diferenciador principal: según evaluaciones públicas, su renderizado de texto en chino puede presentar de forma estable diversas tipografías y contenidos extensos, lo que lo hace idóneo para materiales visuales con textos.
Instrucciones extensas y doble prompt positivo y negativo: el prompt admite hasta 800 caracteres y permite definir además un prompt negativo, controlando por separado los elementos que se deben evitar y el contenido que se debe generar.
Tamaños de salida y reproducibilidad controlables: ofrece cinco tamaños de composición horizontal y vertical de nivel 2K; junto con el parámetro seed, permite reproducir un resultado concreto, lo que facilita el procesamiento por lotes y las pruebas de regresión.

Descripción de capacidades

Generación de imágenes con prompts en chino e inglés: el prompt puede estar en chino o en inglés; se recomienda escribir directamente el texto que se desea renderizar. La salida es una sola imagen, apta para entrar directamente en flujos de diseño o de contenido.

Cinco tamaños de nivel 2K: admite cinco composiciones horizontales y verticales de 2688*1536, 2368*1728, 2048*2048, 1728*2368 y 1536*2688, que se ajustan directamente a formatos como carteles, portadas e imágenes largas.

Restricción mediante prompt negativo: mediante negative_prompt se describen los elementos que se deben evitar, lo que reduce contenido irrelevante o desviaciones de estilo y disminuye el coste de retrabajo y de selección posterior.

Optimización automática del prompt: prompt_extend está activado por defecto y completa automáticamente el prompt para obtener mejores resultados, a costa de una pequeña latencia adicional; puede desactivarse según se necesite.

Reproducción mediante seed y control de marca de agua: seed admite valores de 0 a 2147483647, lo que facilita reproducir un mismo resultado; watermark permite controlar si la salida incluye la marca de agua de generación por IA.

Escenarios de aplicación

Equipos de diseño y marketing: carteles y presentaciones con textos en chino: se introducen prompts con textos explícitos y descripción de maquetación, y se obtienen materiales visuales de nivel 2K listos para maquetar, destinados a promociones de eventos y propuestas comerciales.
Equipos de contenido: creación de cómics de varias viñetas e imágenes largas: se genera viñeta a viñeta según el guion gráfico y, junto con un seed fijo, se mantiene la coherencia de estilo, produciendo conjuntos de ilustraciones para contenido seriado e imágenes largas para redes sociales.
Equipos de ingeniería: canalizaciones automatizadas de generación de imágenes por lotes: se invoca de forma parametrizada con tamaños fijos, seed y prompt negativo, produciendo de forma estable recursos de imagen con especificaciones uniformes que se integran en flujos de producción de contenido y de diseño.

Limitaciones y recomendaciones de selección

La salida máxima es de nivel 2K de resolución; si se necesita 4K o una edición local más precisa, conviene evaluar otros modelos. Este modelo se orienta a la generación de composiciones y a la presentación de texto en chino, y las tareas impulsadas por conocimiento, como la recuperación aumentada o el razonamiento en varios pasos, no son su punto fuerte. El prompt tiene un límite de 800 caracteres, por lo que las instrucciones complejas demasiado largas deben simplificarse. Activar la optimización del prompt añade latencia adicional, por lo que puede desactivarse cuando la latencia sea crítica. La salida es una sola imagen; las necesidades por lotes requieren invocaciones en bucle por cuenta propia.

Novedades

Ver el registro de cambios →

Nuevo modelo qwen-image-2.0-pro ya está disponible: admite texto a imagen, precio estándar $0.107/imagen Oct 31, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué tareas es principalmente adecuado Qwen Image 2.0?

Modelo con una excelente relación calidad-precio que admite chino, prompts negativos, expansión de prompt, Seed opcional y cinco tamaños de píxeles en 2K.
¿Qwen Image 2.0 admite imágenes de referencia?

La ruta actual es de texto a imagen pura, no acepta imágenes de referencia.
¿Qué especificaciones de salida son compatibles?

La página actual muestra 2688×1536, 2368×1728, 2048×2048, 1728×2368, 1536×2688 y ; las opciones finales están sujetas a los parámetros del Playground.
¿Cómo se factura Qwen Image 2.0?

Se factura según la cantidad de imágenes generadas correctamente; si hay diferencias entre distintas resoluciones o niveles de calidad, se mostrarán en el precio en tiempo real de la página.

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-2.0-pro

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria para reproducir el resultado de la generación; debe ser un número entero entre 0 y 2147483647.

sizestringOpcionalPredeterminado: "2048*2048"

Dimensiones de la imagen de salida en formato «ancho*alto»; el total de píxeles debe estar entre 512x512 y 2048x2048; valor predeterminado 2048*2048.

Opciones:2688*15362368*17282048*20481728*23681536*2688

promptstringObligatoriominLength 1maxLength 800

Descripción textual del contenido de la imagen, en chino o inglés; escriba explícitamente el texto que desea que aparezca en la imagen.

watermarkbooleanOpcionalPredeterminado: false

Indica si se añade una marca de agua de IA generada sobre la imagen de salida; valor booleano, predeterminado false.

prompt_extendbooleanOpcionalPredeterminado: true

Indica si se optimiza automáticamente el prompt para obtener mejores resultados de generación; valor booleano, predeterminado true; activarlo aumenta ligeramente la latencia.

negative_promptstringOpcionalPredeterminado: ""

Indica si se añade una marca de agua de IA generada sobre la imagen de salida; valor booleano, predeterminado false.

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-2.0-pro",
  "input": {
    "size": "2048*2048",
    "prompt": "…",
    "watermark": false,
    "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-2.0-pro",
    input: {
      "size": "2048*2048",
      "prompt": "…",
      "watermark": false,
      "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-2.0-pro",
        "input": {
          "size": "2048*2048",
          "prompt": "…",
          "watermark": False,
          "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"
    }
  }
}