API Z-Image: US$ 0,008 por imagem, com saídas reais e código

Resumo em uma frase

• Z-Image é um modelo rápido de texto para imagem lançado pela Tongyi, da Alibaba. No HiAPI, o id do modelo é z-image e o custo é de US$ 0,008 por imagem: 1.000 imagens custam US$ 8.
• A requisição contém apenas dois campos: prompt (até 1.000 caracteres) e aspect_ratio (1:1, 4:3, 3:4, 16:9, 9:16). Não há tamanho, resolução, seed nem entrada de imagem.
• Ele se destaca na geração de fotos de produto de nível fotográfico com textos curtos em inglês. Nos quatro testes abaixo, todo texto foi renderizado corretamente. Abra a página do modelo Z-Image para experimentar; novas contas recebem 200 créditos gratuitos.

Preços

Quantidade de imagens	Custo de z-image
1	US$ 0,008
100	US$ 0,80
600 (200 produtos × 3 imagens)	US$ 4,80
1.000	US$ 8,00

Preço em tempo real do HiAPI, consultado em 20 de outubro de 2026. Preço único para todas as proporções. Tarefas com falha não são cobradas.

Comparação com outros modelos de baixo custo no HiAPI:

Modelo	Por imagem	Texto na imagem
flux-schnell/text-to-image	US$ 0,005	Não é seu ponto forte
z-image	US$ 0,008	Textos curtos em inglês, consistentes em nossos testes
qwen-image-2.1-turbo	US$ 0,02	Suporta chinês e inglês; também aceita imagens de referência
gpt-image-2/text-to-image	US$ 0,03 em resolução 1K	Desempenho forte; também edita imagens

Para mais opções (incluindo vídeo), consulte as APIs de imagem e vídeo mais baratas do HiAPI.

Saídas reais: imagens de produto com texto

Etiqueta de preço (1:1)

Studio e-commerce product photo: a matte black insulated steel water bottle centered on a seamless light-gray background with soft shadow. A rectangular coral paper card leans against the bottle. The card contains ONLY these two lines of bold clean sans-serif text and no other words: line one "SUMMER SALE", line two "$19.99". Text flat-on to camera, large, perfectly legible. Photorealistic.

Gerar com este prompt →

z-image, 1:1, 1536×1536, US$ 0,008.

As duas linhas de texto saíram corretas. O cartão acabou pendurado na alça da garrafa, em vez de encostado ao lado dela. A primeira versão deste prompt dizia "reads exactly: SUMMER SALE on the first line and $19.99 on the second line", e o modelo imprimiu uma palavra extra "ON" entre as duas linhas. Coloque o texto exato entre aspas e deixe as instruções fora das aspas.

Banner largo (16:9)

Wide e-commerce promo banner, photorealistic flat-lay of white sneakers and a kraft shipping box on a pastel blue background. On the right side, bold navy sans-serif text with exactly these four words and amount, nothing else: "FREE SHIPPING OVER $50". All four words must appear. Text large, straight, perfectly legible. Clean commercial studio lighting.

Gerar com este prompt →

z-image, 16:9, 1344×768, US$ 0,008.

Card para redes sociais (3:4)

Vertical social-media product card: a small brown glass cosmetic dropper bottle on a warm beige podium, soft daylight. Above the bottle, bold black modern sans-serif headline text reads exactly: 30% OFF TODAY ONLY. Text flat to camera, large and perfectly legible. Minimalist premium e-commerce style, photorealistic.

Gerar com este prompt →

z-image, 3:4, 928×1232, US$ 0,008.

O texto saiu correto, mas o conta-gotas se sobrepôs à palavra "ONLY". Se o título precisar ficar totalmente visível, indique a posição do produto ("in the lower half, below the text", ou seja, na metade inferior, abaixo do texto).

Texto pequeno em etiqueta (3:4)

Macro e-commerce product photo of a frosted glass skincare bottle with a clean white label. The label text, printed in elegant dark sans-serif, reads exactly: GLOW SERUM on the first line and VITAMIN C 10% on the second line. Straight-on angle, label fully visible and sharp, soft studio lighting, photorealistic, white background.

Gerar com este prompt →

z-image, 3:4, 928×1232, US$ 0,008.

Texto pequeno em superfícies curvas é o mais difícil dos quatro, mas a saída ficou limpa. O modelo quebrou "VITAMIN C 10%" em duas linhas.

Regras para acertar o texto

1. Coloque o texto exato entre aspas.
2. Acrescente "and no other words" (sem outras palavras), para que o modelo não invente textos extras de selo.
3. Deixe o texto de frente para a câmera e plano. Textos inclinados ou curvos são os primeiros a errar.
4. Use apenas um ou dois blocos de texto por imagem. Textos mais longos devem ser compostos depois em uma ferramenta de design.
5. Confira cada imagem antes de publicar. A US$ 0,008, o custo de gerar novamente é praticamente irrelevante.

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"
    }
  }'

Você recebe um taskId. Faça polling em GET https://api.hiapi.ai/v1/tasks/{taskId} até que data.status seja success e então baixe data.output[0].url. O status passa por queued, handling e archiving, até chegar a success ou fail. O link expira cerca de 7 dias após a conclusão da tarefa.

Python: processamento em pequenos lotes

# pip install requests; antes execute 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()}   # envie todos primeiro e depois colete juntos

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 e erros

Campo	Obrigatório	Valores
prompt	Sim	Até 1.000 caracteres
aspect_ratio	Não	1:1, 4:3, 3:4, 16:9, 9:16

As situações abaixo retornam HTTP 400 no envio, não criam tarefa e não são cobradas:

• additional properties 'size' not allowed (ou resolution, width): use aspect_ratio em vez disso.
• aspect_ratio: value must be one of ...: 21:9 ou 4:5 não são suportados. Gere em 16:9 ou 3:4 e depois recorte.
• Uso de um id de modelo como z-image-turbo: o único id no HiAPI é z-image.

Quando usar outro modelo

• Precisa editar uma imagem existente: o Z-Image só gera a partir de texto. Use um modelo de imagem para imagem, como qwen-image-2.1-turbo (US$ 0,02) ou gpt-image-2/image-to-image.
• Textos longos ou densos, ou muito chinês: experimente o Qwen Image, criado para composição bilíngue.
• Busca o menor preço e não precisa de texto: flux-schnell/text-to-image custa US$ 0,005.

Perguntas frequentes

Qual é o id do modelo?

z-image. Não existe um id separado z-image-turbo no HiAPI; Turbo é o nome dessa variante rápida no upstream.

Como obter uma chave de API?

Cadastre-se em hiapi.ai, crie uma chave no console e envie-a como Authorization: Bearer <key>. A mesma chave serve para todos os modelos.

Ele renderiza texto em chinês?

A Alibaba lista o texto bilíngue como ponto forte. Os quatro testes acima foram todos em inglês, então, antes de depender disso, verifique a saída em chinês com seus próprios prompts.

Há configuração de resolução?

Não. O tamanho da saída depende da proporção: nos testes acima, 1:1 retornou 1536×1536, 16:9 retornou 1344×768 e 3:4 retornou 928×1232.

Quer testar um prompt sem escrever código? Abra a página do modelo Z-Image.