Guia de uso

Gerar imagens de produtos de e-commerce com flux-2-klein-9b/text-to-image pela API hiapi

Aug 14, 2026

A maioria dos modelos de texto-para-imagem rápidos e baratos força você a escolher: ou o texto na imagem sai legível, ou o preço é baixo. O flux-2-klein-9b/text-to-image é um dos poucos modelos da faixa "rápido e barato" que não te obriga a abrir mão de um dos dois. As etiquetas que a hiapi atribui a ele são Text Rendering, High Fidelity (renderização de texto, alta fidelidade) — e, na prática, isso significa que ele consegue renderizar, em uma única geração, o logotipo textual da marca, uma linha de texto pequeno em uma etiqueta e um título promocional grande e chamativo, sem precisar rodar uma segunda vez para corrigir letras embaralhadas.

Isso é especialmente importante para imagens de produtos de e-commerce: justamente as imagens que realmente precisam de texto — a imagem principal com etiqueta visível, a faixa de promoção por tempo limitado com o preço indicado — são as que os modelos "rápidos" e baratos mais costumam estragar.

Neste artigo, todas as três imagens foram geradas com o flux-2-klein-9b/text-to-image, sem nenhuma nova tentativa: o texto da etiqueta, o título promocional e a linha de desconto saíram todos limpos e corretos já na primeira geração. Isso não quer dizer que todo prompt tenha essa garantia (veja a dica de revisão abaixo), mas, para um modelo dessa faixa de preço, é um bom sinal.

Preços: flux-2-klein-9b vs. flux-2-klein-4b (texto-para-imagem)

Os dois modelos pertencem à família "Klein" e ambos priorizam velocidade e baixo custo. A diferença está no que você está pagando:

Modelo	Preço por imagem	Etiquetas
`flux-2-klein-9b/text-to-image`	Fixo $0.00858	Text-to-Image, Text Rendering, High Fidelity
`flux-2-klein-4b/text-to-image`	Fixo $0.00143	Text-to-Image, Fast, Cost Efficient

(Preços de 2026-08, confirmados em /api/pricing.)

O flux-2-klein-4b/text-to-image é cerca de 6 vezes mais barato — ideal como escolha padrão para fundos, imagens de estilo de vida ou qualquer imagem em que o texto não faça parte da composição. Mas ele não tem a etiqueta de renderização de texto, então, se o texto em cartões, etiquetas ou faixas precisar ser realmente legível, o klein-9b é a escolha mais segura, mesmo sendo mais caro. E, por menos de um centavo de dólar por imagem, essa "segurança" aqui ainda sai mais barata do que uma única chamada de API de boa parte dos LLMs.

Uma requisição real

Abaixo está uma requisição funcional para o endpoint /v1/tasks, gerando um cartão promocional com texto renderizado:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Banner promocional para redes sociais de uma promoção por tempo limitado de e-commerce: um frasco conta-gotas de vidro fosco, com etiqueta escrita 'VELURA HYDRA SERUM', centralizado sobre um fundo em degradê suave que vai do rosa blush ao creme, no topo um título grande em fonte sem serifa, em negrito e limpa, com o texto 'FLASH SALE', em letras cinza-carvão-escuro, abaixo uma linha de texto menor com o conteúdo '30% OFF', usando a mesma fonte, no canto inferior direito um selo retangular de cantos arredondados com contorno fino, contendo o texto 'VELURA', tipografia nítida e legível, espaçamento equilibrado, design de marketing moderno e minimalista, sem outros textos, sem marca d'água",
      "aspect_ratio": "1:1"
    }
  }'

A requisição retorna um taskId. Faça polling em GET /v1/tasks/{taskId} até que status seja success e então baixe output[0].url — os links assinados expiram, então puxe os bytes imediatamente e armazene você mesmo.

Observações sobre o schema: o que funciona na prática

Antes de desenvolver com base nesse modelo, vale conhecer alguns pontos, baseados no que a API realmente aceita (e não apenas na documentação):

resolution é rejeitado. Diferentemente de alguns outros modelos de imagem da hiapi, enviar o campo resolution retorna 400 (additional properties not allowed). Envie apenas aspect_ratio.
aspect_ratio é uma lista curta e fixa: 1:1, 4:3, 3:4, 16:9, 9:16. Não há 4:5 nem 21:9 — se o seu layout pede um recorte vertical mais alto, 3:4 é a proporção suportada mais próxima (é a que usamos na imagem de estilo de vida abaixo).
O próprio aspect_ratio é opcional. Omiti-lo por completo ainda gera uma imagem válida, usando o padrão do servidor — mas, no trabalho com e-commerce, você quase sempre quer um enquadramento definido (quadrado para posts de feed, 16:9 para banners principais), então vale defini-lo explicitamente em vez de depender do padrão.
Preço fixo por imagem, sem faixas por resolução. Diferentemente do flux-2-klein-4b/image-to-image (com cinco faixas de preço por megapixel), o klein-9b/text-to-image tem uma tarifa única, independentemente da proporção.

Prompt + resultado: imagem principal

Prompt (16:9, usado como está, sem modificações após a geração):

Imagem principal de produto de e-commerce: um frasco conta-gotas de vidro fosco cheio de sérum facial de alto padrão, sobre uma placa de mármore cinza úmida, luz do dia suave vindo da esquerda projetando um reflexo delicado, fundo bege minimalista, pequenas gotas de água no mármore, a etiqueta no frasco diz claramente 'VELURA', em uma fonte serifada moderna e limpa, abaixo um texto menor 'HYDRA SERUM', fotografia de produto profissional de estúdio, foco nítido, luz de contorno sutil, sem outros textos, sem mãos, sem marca d'água de logo

(A imagem está no topo deste artigo.) O nome da marca e a linha de produto saíram limpos a uma distância de leitura normal — sem letras duplicadas, sem serifas derretidas, que é justamente o modo de falha comum em modelos de texto-para-imagem baratos nessa faixa de preço.

Prompt + resultado: cena de estilo de vida

Prompt (3:4):

Foto de e-commerce em estilo de vida: um frasco conta-gotas de vidro fosco com etiqueta escrita 'VELURA HYDRA SERUM', sobre uma bancada de banheiro iluminada, ao lado de uma toalha branca dobrada e um pequeno ramo de eucalipto em vaso, luz da manhã quente entrando pela janela, sombras suaves, profundidade de campo rasa, composição natural e descontraída, o texto da etiqueta do frasco 'VELURA' e 'HYDRA SERUM' permanece nítido e legível, sem pessoas, sem mãos, sem sobreposição de textos extras

Imagens de estilo de vida como essa normalmente nem precisam de texto na imagem — mas a etiqueta ainda precisa se sustentar sob uma iluminação mais suave e difusa do que na imagem principal de estúdio, e isso é um teste mais difícil para a fidelidade de texto do modelo.

Prompt + resultado: cartão de promoção por tempo limitado

Prompt (1:1):

Banner promocional para redes sociais de uma promoção por tempo limitado de e-commerce: um frasco conta-gotas de vidro fosco com etiqueta escrita 'VELURA HYDRA SERUM', centralizado sobre um fundo em degradê suave que vai do rosa blush ao creme, no topo um título grande em fonte sem serifa, em negrito e limpa, com o texto 'FLASH SALE', em letras cinza-carvão-escuro, abaixo uma linha de texto menor com o conteúdo '30% OFF', usando a mesma fonte, no canto inferior direito um selo retangular de cantos arredondados com contorno fino, contendo o texto 'VELURA', tipografia nítida e legível, espaçamento equilibrado, design de marketing moderno e minimalista, sem outros textos, sem marca d'água

Essa é a imagem que realmente põe à prova a etiqueta "Text Rendering, High Fidelity" do modelo: duas linhas de texto de título e mais o texto de um pequeno selo, tudo em uma única geração. Cada palavra está escrita corretamente e o espaçamento entre letras também se manteve adequado — mas, justamente por isso, você ainda deve revisar com os próprios olhos antes de publicar (veja abaixo).

Não pule a revisão

O próprio guia de conteúdo da hiapi é direto quanto a isso: a renderização de texto por IA é "99%, não 100%". Mesmo modelos com a etiqueta de texto de alta fidelidade às vezes erram a grafia de uma palavra, omitem uma letra ou juntam duas palavras — especialmente em textos pequenos de etiqueta, mais do que em títulos grandes (texto pequeno é mais difícil). Antes de publicar um cartão promocional ou uma etiqueta de produto gerada:

Amplie para 100% e examine cada linha de texto renderizado.
Verifique a grafia e o espaçamento, não apenas se "parece texto".
Se algo estiver errado, gere de novo — não edite os pixels manualmente, porque uma nova execução custa uma fração de centavo.
Para textos que mudam com frequência (preços, datas de promoção), considere sobrepor na sua própria etapa de template em vez de incorporá-los a cada geração — atualizar sai mais barato e elimina totalmente o risco de ter que rodar de novo.

Geração em lote com Python

Para um catálogo completo de produtos, basta envolver o mesmo padrão de requisição em um laço:

import requests
import time

API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt, aspect_ratio="1:1"):
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "flux-2-klein-9b/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
        },
    )
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(
            f"{BASE}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        ).json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(task["error"])
        time.sleep(5)

prompts = [
    ("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
    ("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
    ("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]

for prompt, ratio in prompts:
    url = generate(prompt, ratio)
    print(url)  # baixe imediatamente — a URL expira

Com $0.00858 por imagem, um catálogo de 50 SKUs, com 3 imagens por SKU (principal, estilo de vida e promoção), sai por cerca de $1.29 no total — comparado a uma sessão de fotografia de produto freelancer, isso é praticamente uma bagatela.

flux-2-klein-9b/text-to-image em comparação com fluxos de trabalho relacionados

Se você está montando um pipeline de imagens de produto mais completo na hiapi, vale ler a seguir algumas seções relacionadas:

Se você precisa editar ou mudar o estilo de fotos de produto existentes, em vez de gerar do zero, veja flux-2-klein-4b para retoque de e-commerce com imagem-para-imagem — é uma tarefa diferente (i2i, não t2i), criada para retocar fotos reais em vez de gerar novas cenas.
Sobre padrões de prompt específicos do modo imagem-para-imagem da faixa 9b (a mesma força de renderização de texto, aplicada à edição), veja prompts de imagem-para-imagem do flux-2-klein-9b.
Parâmetros completos, preço em tempo real e um console para testar prompts antes de rodar em lote: página do modelo flux-2-klein-9b/text-to-image.

Perguntas frequentes

O flux-2-klein-9b/text-to-image suporta imagem-para-imagem? Não — esse endpoint específico só suporta texto-para-imagem. A hiapi lista separadamente um modelo flux-2-klein-9b/image-to-image (preço de $0.03143/imagem) para editar fotos existentes.

Quais proporções são suportadas? Cinco: 1:1, 4:3, 3:4, 16:9, 9:16. Não há 4:5 nativo — use 3:4 para obter um recorte vertical semelhante.

Posso definir a resolução de saída? Não. Enviar o campo resolution retorna 400. O preço e o tamanho da saída são fixos por proporção.

Sairia mais barato usar o flux-2-klein-4b? Sim, cerca de 6 vezes mais barato por imagem ($0.00143 contra $0.00858) — mas o klein-4b não tem a etiqueta de renderização de texto. Use-o para imagens sem texto (cenas de estilo de vida puras ou imagens de fundo) e deixe o klein-9b para qualquer imagem com etiqueta, título ou preço indicado.

Quanto tempo leva a geração? Todas as três imagens deste artigo, pelo fluxo de polling do /v1/tasks, ficaram prontas em menos de dois minutos cada.

Experimente

Você pode testar o flux-2-klein-9b/text-to-image diretamente na página do modelo, com os seus próprios prompts, antes de integrar a tarefas em lote; e consultar as tarifas atuais a qualquer momento na página de preços. O schema completo de requisição/resposta e a configuração de autenticação estão na documentação da API.

Etiquetasecommerce Geração de Imagens Guia