Alibaba

Qwen Image 2.0

qwen-image-2.0

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

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

qwen-image-2.0 per image

Precio unitario	$0.0422

Descripción general

Qwen-Image-2.0 es un modelo de generación de imágenes lanzado por Alibaba, disponible para su invocación en HiAPI.ai a través de una interfaz de texto a imagen. Está orientado a desarrolladores que necesitan generar imágenes de alta resolución y renderizar texto en chino; admite prompts positivos y negativos de hasta 800 caracteres, puede generar imágenes de nivel 2K y permite elegir entre composición horizontal y vertical, además de ofrecer reescritura inteligente de prompts y reproducción mediante semilla. Es adecuado para procesos de producción de contenido como carteles, presentaciones e imágenes largas con texto, donde se requiere una presentación estable de texto en chino y control de la composición en la generación de imágenes por lotes.

Aspectos destacados

El renderizado de texto en chino es el principal diferenciador: presenta de forma estable diversas tipografías y textos largos en chino, adecuado para generar materiales visuales con títulos y cuerpo de texto.
Resolución de nivel 2K y múltiples formatos: los tamaños de salida cubren desde 1536×2688 hasta 2688×1536, en total cinco opciones, lo que abarca tanto carteles verticales como banners horizontales.
Reescritura de prompts y semilla aleatoria: la reescritura inteligente de prompts está activada por defecto para completar la descripción y, junto con el parámetro de semilla, permite reproducir el mismo resultado en la medida de lo posible.

Descripción de capacidades

Control mediante prompts positivos y negativos: el prompt positivo admite hasta 800 caracteres y el negativo hasta 500, lo que permite describir el contenido de la imagen y excluir elementos no deseados al mismo tiempo, reduciendo las pruebas repetidas.

Cinco tamaños de salida: se especifica la proporción de salida mediante WIDTH*HEIGHT; el valor predeterminado es 2048*2048, y hay otras cuatro opciones verticales y horizontales, lo que facilita que una sola llamada coincida directamente con el espacio de publicación.

Reescritura inteligente de prompts: prompt_extend está activado por defecto y el modelo completa las descripciones breves; si se necesita seguir estrictamente la descripción original, se puede desactivar explícitamente.

Resultados de generación reproducibles: al fijar la semilla aleatoria mediante seed, se puede reproducir la misma imagen en la medida de lo posible con parámetros idénticos, lo que facilita la comparación de versiones y la depuración por lotes.

Control opcional de marca de agua: el parámetro watermark controla si se añade la marca de agua de Qwen-Image, de modo que se puede decidir según el canal de publicación si la imagen final lleva identificación.

Casos de uso

Equipos de marketing que producen carteles en chino por lotes: introducen prompts con título principal y puntos de venta, y generan imágenes finales en el tamaño vertical especificado, listas para páginas de campaña y publicaciones en redes sociales.
Equipos de contenido que crean imágenes largas con texto y viñetas de cómic: usan prompts largos para describir composiciones de varias viñetas y texto de diálogo, y obtienen las ilustraciones correspondientes para imágenes largas de cuentas oficiales o contenido seriado.
Exploración de borradores en el flujo de diseño: se parte de prompts breves con reescritura inteligente para generar imágenes por lotes, se filtran direcciones con una semilla fija y luego se usan como referencia para el diseño definitivo.

Limitaciones y recomendaciones de selección

La salida máxima es de nivel 2K; si se necesita mayor resolución o edición local precisa, conviene evaluar otros modelos que admitan mayor resolución y capacidades de edición. Sus límites de capacidad se centran en texto a imagen y renderizado de texto, por lo que no es adecuado para tareas impulsadas por conocimiento, como recuperación aumentada o razonamiento en varios pasos. La interfaz solo acepta prompts de texto y no incluye canal de entrada de imágenes, por lo que no puede modificar imágenes existentes. Cuando se necesite generar imágenes siguiendo estrictamente la descripción original, se recomienda desactivar la reescritura de prompts y fijar la semilla para controlar las variables.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria utilizada para reproducir en la medida de lo posible el mismo resultado con los mismos parámetros. Se pasa un número entero; si no se proporciona, el servidor la genera aleatoriamente.

sizestringOpcionalPredeterminado: "2048*2048"

Tamaño de la imagen de salida, como una cadena con formato ancho*alto. Valor predeterminado 2048*2048.

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

promptstringObligatoriomaxLength 800

Prompt positivo, utilizado para describir el contenido, el estilo y la composición de la imagen que se desea generar.

watermarkbooleanOpcionalPredeterminado: false

Indica si se añade la marca de agua de Qwen-Image a la imagen de salida. Valor predeterminado false.

prompt_extendbooleanOpcionalPredeterminado: true

Indica si se activa la reescritura inteligente del prompt, que amplía y optimiza automáticamente el prompt introducido. Valor predeterminado true.

negative_promptstringOpcionalPredeterminado: ""maxLength 500

Prompt negativo, utilizado para describir el contenido que no se desea que aparezca en el resultado generado. Valor predeterminado 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-2.0",
  "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",
    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",
        "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"
    }
  }
}