Integración de la API de Qwen Image 3.0 Pro: curl, Python y todos los parámetros

Qwen Image 3.0 Pro (通义千问图像 3.0 Pro) tiene dos puntos de entrada en HiAPI: texto a imagen qwen-image-3.0-pro/text-to-image e imagen a imagen qwen-image-3.0-pro/image-to-image. Es más caro que la versión estándar, pero a cambio ofrece más detalle y texturas, y sigue escribiendo con precisión texto en chino e inglés. Este artículo ofrece ejemplos de curl y Python listos para ejecutar, todos los parámetros actuales y varios puntos a tener en cuenta antes de lanzarlo a producción.

Los nombres de modelo antiguos qwen-image-3.0-pro y el campo size ya no están disponibles: el nombre de modelo antiguo devuelve MODEL_UNAVAILABLE y size se rechaza como campo desconocido. Usa los dos nombres de modelo anteriores junto con aspect_ratio y resolution.

Primero, los precios

	1K (predeterminado)	2K
Pro texto a imagen / imagen a imagen	$0.0497	$0.0993
Versión estándar texto a imagen / imagen a imagen (referencia)	$0.0358	$0.0358

Precios actuales de HiAPI, verificados el 18 de octubre de 2026.

Pro 1K es aproximadamente un 39 % más caro que la versión estándar, y 2K cuesta aproximadamente 2,8 veces más que la estándar. Las 1–3 imágenes de referencia de imagen a imagen no tienen coste adicional. Los fallos no se cobran.

Una imagen generada real

16:9. Tanto «深海来信» en la placa de latón sobre la mesa como la línea pequeña debajo, «LETTERS FROM THE DEEP», están escritos correctamente palabra por palabra:

High-end cinematic architectural editorial photograph inside a futuristic underwater restaurant at midnight. A vast curved observation window fills the background with deep cobalt water and luminous translucent jellyfish drifting outside. On the right, a sculptural dining table of black stone, hand-blown glass and restrained brushed brass catches a narrow beam of warm light. A small refined brass menu plaque on the table is naturally photographed and contains only the exact Chinese characters “深海来信”; directly below, the exact English words “LETTERS FROM THE DEEP”. The left third remains calm dark-blue negative space with volumetric light rays. No poster layout; this must feel like an expensive real location photographed for an architecture magazine. cinematic composition, dramatic directional lighting, rich cohesive cobalt-and-gold color grade, ultra-detailed, premium commercial finish, subtle film grain, shallow depth of field, high dynamic range, 16:9 hero composition

Generar con este prompt →

qwen-image-3.0-pro/text-to-image, 16:9, imagen de ejemplo de la página del modelo.

Genera tu primera imagen

Preparación: crea una API Key en la consola. Los nuevos usuarios reciben 200 créditos al registrarse.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
      "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
      "aspect_ratio": "4:3",
      "resolution": "1K",
      "prompt_extend": false
    }
  }'

Después de recibir taskId, consulta el resultado:

curl -s https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Cuando data.status sea success, la imagen estará en data.output[0].url. Es un enlace temporal; descárgala y guárdala en cuanto la obtengas.

Python

import os, time, requests

KEY = os.environ["HIAPI_KEY"]
BASE = "https://api.hiapi.ai/v1"
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

r = requests.post(f"{BASE}/tasks", headers=H, json={
    "model": "qwen-image-3.0-pro/text-to-image",
    "input": {
        "prompt": "一只青瓷茶壶放在胡桃木桌上，清晨的侧光，茶壶旁的小卡片上写着「雨前龙井」",
        "aspect_ratio": "4:3",
        "resolution": "1K",
        "prompt_extend": False,
    },
})
task_id = r.json()["data"]["taskId"]

while True:
    d = requests.get(f"{BASE}/tasks/{task_id}", headers=H).json()["data"]
    if d["status"] in ("success", "fail"):
        break
    time.sleep(5)

if d["status"] == "success":
    open("result.png", "wb").write(requests.get(d["output"][0]["url"]).content)
else:
    print(d)

Todos los parámetros

Campo	Obligatorio	Valores	Descripción
prompt	Sí	Máximo 18000 caracteres	Contenido, estilo y composición de la imagen; el texto que debe aparecer se escribe entre comillas
image_urls	Obligatorio para imagen a imagen	1–3 imágenes	JPEG/PNG/WEBP/BMP/GIF/TIFF, ≤10MB por imagen, no admite SVG
aspect_ratio	No	1:1 (predeterminado), 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9
resolution	No	1K (predeterminado) / 2K	Determina el precio
output_format	No	png (predeterminado) / jpeg
prompt_extend	No	Booleano, predeterminado true	Reescribe el prompt automáticamente; si necesitas que el texto sea exacto palabra por palabra, configúralo en false
negative_prompt	No	Máximo 500 caracteres	Contenido que no quieres que aparezca
seed	No	0–2147483647	Fijarlo facilita la reproducibilidad

Ejemplo de imagen a imagen:

{
  "model": "qwen-image-3.0-pro/image-to-image",
  "input": {
    "prompt": "把这张产品图修成高端杂志风格，保留瓶身形状和标签上的文字",
    "image_urls": ["https://example.com/product.jpg"],
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "prompt_extend": false
  }
}

Errores habituales

Todos se devuelven de forma síncrona con HTTP 400 al enviar la solicitud; no se crea la tarea ni se cobra:

• MODEL_UNAVAILABLE: usaste el nombre de modelo antiguo qwen-image-3.0-pro; cámbialo por el nombre con /text-to-image o /image-to-image.
• additional properties 'size' not allowed: size ya no se acepta; usa aspect_ratio junto con resolution.
• resolution: value must be one of '1K', '2K': Pro no tiene 4K.
• image_urls: minItems: got 0, want 1: imagen a imagen requiere al menos 1 imagen de referencia.

Antes de lanzarlo a producción

• Desactiva prompt_extend al escribir texto: la reescritura automática puede modificar las palabras que necesitas.
• Usa callbacks en lugar de polling: añade en el nivel superior del cuerpo de la solicitud "callback": {"url": "https://tu-dominio/hiapi/callback", "when": "final"} y deduplica por taskId.
• Evita cobros duplicados: incluye la cabecera Idempotency-Key al enviar la solicitud y reutiliza la misma key en los reintentos por timeout.
• Guarda los resultados a tiempo: los enlaces de salida caducan.

Preguntas frecuentes

¿Cómo elegir entre Pro y la versión estándar?

Prueba primero la versión estándar, $0.0358 por imagen, con el mismo precio para 1K y 2K. Cambia a Pro cuando la versión estándar no ofrezca suficiente detalle. Para la integración de la versión estándar, consulta Integración de la API de Qwen Image 3.0.

¿Puede generar 4K?

No, solo 1K y 2K.

¿Cuántas imágenes de referencia como máximo?

3, sin coste adicional.

También puedes copiar directamente el prompt del restaurante submarino anterior y generar en la página del modelo.