API de Z-Image: $0.008 por imagen, resultados reales y código

Resumen en una frase

• Z-Image es un modelo rápido de texto a imagen de Alibaba Tongyi. En HiAPI, el id del modelo es z-image y el costo es de $0.008 por imagen: 1,000 imágenes cuestan $8 en total.
• La solicitud solo contiene dos campos: prompt (máximo 1,000 caracteres) y aspect_ratio (1:1, 4:3, 3:4, 16:9, 9:16). No hay tamaño, resolución, seed ni entrada de imagen.
• Destaca generando imágenes de producto fotorrealistas con texto corto en inglés. En las siguientes cuatro pruebas, todo el texto se generó correctamente. Abre la página del modelo Z-Image para probarlo; las cuentas nuevas reciben 200 créditos gratis.

Precios

Cantidad de imágenes	Costo de z-image
1	$0.008
100	$0.80
600 (200 productos × 3 imágenes)	$4.80
1,000	$8.00

Precio en tiempo real de HiAPI, consultado el 20 de octubre de 2026. Precio único para todas las relaciones de aspecto. Las tareas fallidas no se cobran.

Comparación con otros modelos de bajo costo en HiAPI:

Modelo	Por imagen	Texto en la imagen
flux-schnell/text-to-image	$0.005	No es su punto fuerte
z-image	$0.008	Texto corto en inglés, fiable en nuestras pruebas
qwen-image-2.1-turbo	$0.02	Compatible con chino e inglés; también acepta imágenes de referencia
gpt-image-2/text-to-image	$0.03 a resolución 1K	Rendimiento sólido; también permite editar imágenes

Para más opciones (incluido video), consulta las API de imagen y video más económicas en HiAPI.

Resultados reales: imágenes de producto con texto

Etiqueta de precio (1:1)

Fotografía de producto de e-commerce de estudio: una botella de agua de acero inoxidable térmica de color negro mate centrada sobre un fondo gris claro continuo, con una sombra suave. Una tarjeta de papel rectangular color coral se apoya contra la botella. La tarjeta contiene SOLO las siguientes dos líneas de texto en negrita, limpio y sin serifa, sin ninguna otra palabra: en la primera línea "SUMMER SALE", en la segunda línea "$19.99". Texto plano frente a la cámara, grande y perfectamente legible. Fotorrealista.

Generar con este prompt →

z-image, 1:1, 1536×1536, $0.008.

Ambas líneas de texto salieron correctas. La tarjeta terminó colgando del asa de la botella, en lugar de apoyada a su lado. La primera versión de este prompt decía "reads exactly: SUMMER SALE on the first line and $19.99 on the second line", y el modelo imprimió una palabra extra "ON" entre las dos líneas. Coloca el texto exacto entre comillas y deja las instrucciones fuera de las comillas.

Banner panorámico (16:9)

Banner promocional de e-commerce panorámico, fotografía cenital fotorrealista: unas zapatillas deportivas blancas y una caja de envío de papel kraft sobre un fondo azul suave. A la derecha, texto en negrita azul marino sin serifa con exactamente estas cuatro palabras y el importe, nada más: "FREE SHIPPING OVER $50". Deben aparecer las cuatro palabras. Texto grande, recto y perfectamente legible. Iluminación de estudio comercial limpia.

Generar con este prompt →

z-image, 16:9, 1344×768, $0.008.

Tarjeta para redes sociales (3:4)

Tarjeta de producto vertical para redes sociales: un pequeño frasco cuentagotas de cosmética de vidrio marrón sobre un podio beige cálido, luz natural suave. Encima del frasco, un titular en negrita negro moderno sin serifa que dice exactamente: 30% OFF TODAY ONLY. Texto plano frente a la cámara, grande y perfectamente legible. Estilo minimalista de e-commerce premium, fotorrealista.

Generar con este prompt →

z-image, 3:4, 928×1232, $0.008.

El texto salió correcto, pero el cuentagotas se superponía a la palabra "ONLY". Si el titular debe quedar despejado, indica la posición del producto ("in the lower half, below the text", es decir, en la mitad inferior, debajo del texto).

Texto pequeño en etiqueta (3:4)

Fotografía macro de producto de e-commerce: un frasco de cuidado de la piel de vidrio esmerilado con una etiqueta blanca limpia. El texto de la etiqueta, impreso en una elegante tipografía oscura sin serifa, dice exactamente: GLOW SERUM en la primera línea y VITAMIN C 10% en la segunda línea. Ángulo frontal, etiqueta totalmente visible y nítida, iluminación de estudio suave, fotorrealista, fondo blanco.

Generar con este prompt →

z-image, 3:4, 928×1232, $0.008.

El texto pequeño sobre una superficie curva es el más difícil de los cuatro, pero el resultado salió limpio. El modelo distribuyó "VITAMIN C 10%" en dos líneas.

Reglas para que el texto salga correcto

1. Coloca el texto exacto entre comillas.
2. Añade "and no other words" (sin otras palabras) para que el modelo no invente textos adicionales de insignias.
3. Haz que el texto quede plano frente a la cámara. El texto inclinado o curvado es el primero en fallar.
4. Incluye solo uno o dos bloques de texto por imagen. Los textos más largos, maquétalos después en una herramienta de diseño.
5. Revisa cada imagen antes de publicarla. A $0.008, regenerar una vez cuesta prácticamente nada.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "input": {
      "prompt": "A cozy coffee shop at golden hour, a wooden A-frame sign on the sidewalk reading \"FRESH COFFEE\", warm window light, photorealistic",
      "aspect_ratio": "16:9"
    }
  }'

Recibirás un taskId. Consulta GET https://api.hiapi.ai/v1/tasks/{taskId} hasta que data.status sea success, y luego descarga data.output[0].url. El estado pasa por queued, handling y archiving, y finalmente cambia a success o fail. El enlace caduca aproximadamente 7 días después de completarse la tarea.

Python: procesamiento por lotes pequeños

# pip install requests; primero ejecuta export HIAPI_KEY=your-key
import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def submit(prompt, ratio="1:1"):
    r = requests.post(API, json={"model": "z-image", "input": {"prompt": prompt, "aspect_ratio": ratio}},
                      headers=H, timeout=30).json()
    if r.get("code") != 200:
        raise RuntimeError(r)
    return r["data"]["taskId"]

def wait(task_id, timeout_s=300):
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] in ("success", "fail"):
            return d
        time.sleep(3)
    raise TimeoutError(task_id)

products = {"mug-sage": "sage green", "mug-navy": "navy blue", "mug-terracotta": "terracotta"}
tasks = {sku: submit(f'Studio photo of a {color} ceramic coffee mug on white, a small card reads "NEW"')
         for sku, color in products.items()}   # primero envía todo, luego recopila en conjunto

for sku, task_id in tasks.items():
    d = wait(task_id)
    if d["status"] == "success":
        with open(f"{sku}.png", "wb") as f:
            f.write(requests.get(d["output"][0]["url"], timeout=120).content)
    else:
        print(sku, "failed:", d.get("error"))

Parámetros y errores

Campo	Obligatorio	Valores
prompt	Sí	Máximo 1,000 caracteres
aspect_ratio	No	1:1, 4:3, 3:4, 16:9, 9:16

Los siguientes casos devuelven HTTP 400 al enviar, no crean la tarea ni generan cobro:

• additional properties 'size' not allowed (o resolution, width): usa aspect_ratio en su lugar.
• aspect_ratio: value must be one of ...: 21:9 o 4:5 no están admitidos. Genera primero en 16:9 o 3:4 y luego recorta.
• Usar un id de modelo como z-image-turbo: el único id en HiAPI es z-image.

Cuándo conviene usar otro modelo

• Necesitas editar una imagen existente: Z-Image solo genera a partir de texto. Usa un modelo de imagen a imagen, como qwen-image-2.1-turbo ($0.02) o gpt-image-2/image-to-image.
• El texto es largo o denso, o hay mucho chino: prueba Qwen Image, diseñado para composición bilingüe.
• Buscas el precio más bajo y no necesitas texto: flux-schnell/text-to-image cuesta $0.005.

Preguntas frecuentes

¿Cuál es el id del modelo?

z-image. En HiAPI no existe un id separado z-image-turbo; Turbo es el nombre que recibe esta variante rápida en el proveedor original.

¿Cómo obtengo una clave de API?

Regístrate en hiapi.ai, crea una clave en la consola y envíala como Authorization: Bearer <key>. La misma clave sirve para todos los modelos.

¿Puede renderizar texto en chino?

Alibaba incluye el texto bilingüe entre sus puntos fuertes. Las cuatro pruebas anteriores son todas en inglés, así que antes de depender de ello, comprueba la salida en chino con tus propios prompts.

¿Hay ajuste de resolución?

No. El tamaño de salida depende de la relación de aspecto: en las pruebas anteriores, 1:1 devolvió 1536×1536, 16:9 devolvió 1344×768 y 3:4 devolvió 928×1232.

¿Prefieres probar los prompts sin escribir código? Abre la página del modelo Z-Image.