Ideogram V4 para imagens de produtos de e-commerce: um fluxo de trabalho prático

Se o visual do seu produto depende das palavras que ele contém — selos promocionais, marcações de preço, textos de rótulos, títulos de banners — então, no hiapi, o Ideogram V4 é o modelo a escolher. Ele é o especialista em tipografia da plataforma e, nas três peças de e-commerce independentes geradas para este guia (um banner promocional, um mockup de rótulo de produto e um gráfico de oferta relâmpago), cada palavra foi renderizada de forma nítida e correta já na primeira geração, exceto pelas escolhas de texto do próprio design. A seguir estão as abordagens que funcionaram na prática, os prompts reais por trás de cada imagem e um script em lote que transforma uma lista inteira de produtos em gráficos alinhados à identidade da marca.

Por que usar o Ideogram V4 para visuais de e-commerce

A maioria dos modelos de imagem de uso geral ainda erra em títulos com várias palavras, etiquetas de preço ou textos de rótulos — letras extras, espaçamento distorcido ou texto cortado no meio de uma palavra. Esse é exatamente o tipo de falha que gráficos de e-commerce não toleram: um banner com texto embaralhado parece quebrado, não estilizado. O Ideogram V4 foi construído em torno de texto preciso dentro da imagem, o que o torna mais adequado que modelos de uso geral para os seguintes cenários:

• Banners promocionais com título principal + texto de subtítulo (por exemplo, "SUMMER SALE" / "UP TO 40% OFF")
• Mockups de rótulos de produto em que o nome da marca e o texto do produto precisam ser legíveis corretamente
• Gráficos de promoção e contagem regressiva com anotações de texto curtas e de alto contraste

É um modelo puramente texto-para-imagem — não há modo imagem-para-imagem, então é adequado para gerar gráficos a partir de um briefing textual, e não para editar fotos de produtos existentes. Se você precisa editar fotos existentes ou compor sobre elas, isso é trabalho para modelos i2i; consulte o schema completo de entradas na página do modelo Ideogram V4.

Preços do Ideogram V4: três níveis de velocidade

O Ideogram V4 oferece três níveis de rendering_speed, com preços que variam conforme o nível — em setembro de 2026, segundo a página de preços do hiapi:

Nível	Preço por imagem	Cenário de uso
TURBO	$0.05	Rascunhos rápidos, teste de variações de prompt
BALANCED	$0.10	Padrão — banners e rótulos de nível de produção
QUALITY	$0.17	Peças visuais principais finais, quando pequenos detalhes de texto são mais importantes

Os três exemplos abaixo foram gerados com BALANCED, que já oferece resolução e fidelidade de texto suficientes para banners e rótulos de produtos padrão. Reserve o QUALITY para peças visuais principais que serão ampliadas (como banners de página inicial) e use o TURBO enquanto ainda estiver iterando textos e layouts.

Três saídas reais

1. Banner promocional com texto de título

Prompt usado (rendering_speed: BALANCED, aspect_ratio: 16:9):

Um banner promocional de e-commerce limpo, 16:9. No topo, texto de título em negrito com fonte sans-serif moderna e grande, "SUMMER SALE", e abaixo dele um texto de subtítulo com peso menor, "UP TO 40% OFF". Fundo em estilo de fotografia de produto minimalista, gradiente pastel suave (pêssego a creme), com um par de fones de ouvido sem fio brancos e um smartwatch preto fosco dispostos sobre um pedestal discreto no canto inferior direito. Deixe bastante espaço negativo no lado esquerdo para o texto. Iluminação de estúdio, sombras suaves, textura de catálogo de varejo premium.

As duas linhas de texto ficaram legíveis e escritas corretamente já na primeira geração — sem necessidade de novas tentativas. A instrução de espaço negativo no prompt fez diferença aqui: sem ela, o Ideogram V4 tende a centralizar o título sobre a fotografia do produto, o que prejudica a legibilidade quando você coloca o banner em um layout real de página.

2. Mockup de rótulo de produto

Prompt usado (rendering_speed: BALANCED, aspect_ratio: 1:1):

Um mockup de rótulo de produto para um pote de skincare, formato quadrado 1:1. Pote de cerâmica branca centralizado sobre fundo bege claro, com o texto do nome da marca "AURELIA" no topo do rótulo que envolve o pote, em fonte serifada elegante, e abaixo dele um texto menor em fonte sans-serif limpa, "HYDRATING FACE CREAM — 50ML". Iluminação de estúdio suave, sombra tênue sob o pote, estilo minimalista de fotografia de embalagem de skincare.

Este é o caso mais difícil: textos pequenos de rótulo envolvendo uma superfície curva são exatamente onde a renderização de texto tende a falhar. O Ideogram V4 manteve tanto o nome da marca quanto a linha menor de descrição do produto legíveis na primeira tentativa — mas ainda vale a pena uma revisão humana de qualquer forma (veja a observação abaixo), porque texto em rótulo curvo foi o layout mais propenso a erros que testamos.

3. Banner de oferta relâmpago

Prompt usado (rendering_speed: BALANCED, aspect_ratio: 16:9):

Um banner de oferta relâmpago para loja online, 16:9. Texto grande em negrito "FLASH SALE", em vermelho-alaranjado vivo, sobre fundo azul-marinho escuro, com um padrão sutil de faixas de luz diagonais. Abaixo dele, um texto menor em branco, "24 HOURS ONLY". No canto inferior direito, um gráfico de etiqueta de preço vermelha com o texto "-50%". Estilo moderno de marketing de varejo com alto contraste e senso de urgência, formas geométricas limpas, sem poluição visual.

Uma composição com três elementos de texto distintos (título principal, subtítulo e anotação da etiqueta de preço), todos legíveis. Esquemas de alto contraste como esse azul-marinho escuro com vermelho-alaranjado parecem ajudar — aqui, as três gerações seguiram o mesmo padrão: forte contraste entre fundo e primeiro plano está associado a bordas de texto mais limpas.

Independentemente de quão bons sejam os resultados dos testes do modelo, há uma regra: revise cada palavra renderizada antes de publicar. A precisão de renderização de texto do Ideogram V4 é muito alta, mas não é 100% — ocasionalmente uma execução ainda corta uma letra ou erra o espaçamento em linhas mais longas. Confira cada geração em relação ao texto pretendido antes de publicá-la; não publique texto renderizado por IA em uma loja online sem verificação.

Chamando o Ideogram V4 pela API hiapi

O Ideogram V4 roda no endpoint de tarefas assíncronas do hiapi. Você envia a tarefa, faz polling até a conclusão e então baixa a saída — não há resposta síncrona de imagem.

import time
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.hiapi.ai/v1/tasks"

def generate_image(prompt, rendering_speed="BALANCED", aspect_ratio="16:9"):
    payload = {
        "model": "ideogram-v4",
        "input": {
            "prompt": prompt,
            "rendering_speed": rendering_speed,
            "aspect_ratio": aspect_ratio,
        },
    }
    response = requests.post(
        BASE_URL,
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
        },
        json=payload,
    )
    response.raise_for_status()
    task_id = response.json()["data"]["taskId"]

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

image_url = generate_image('Bold headline text "FLASH SALE" on a dark navy banner')
print(image_url)

Apenas três campos de entrada são aceitos: prompt (obrigatório), rendering_speed (obrigatório — um de TURBO, BALANCED, QUALITY) e aspect_ratio (opcional, por exemplo 16:9, 1:1, 9:16, 4:3, 3:4). Este modelo não tem negative_prompt, seed nem campos de entrada de imagem — consulte a referência completa de parâmetros na página do modelo Ideogram V4.

Gerando um catálogo completo de imagens de produto em lote

Para um catálogo de produtos real, você não gera apenas um banner por vez — você passa uma lista inteira de produtos ou campanhas pela mesma esteira durante a noite. Abaixo está uma versão em lote que lê um CSV de prompts e baixa cada resultado:

import csv
import os
import time
import requests

API_KEY = os.environ["HIAPI_API_KEY"]
BASE_URL = "https://api.hiapi.ai/v1/tasks"
OUT_DIR = "output"

def create_task(prompt, rendering_speed, aspect_ratio):
    payload = {
        "model": "ideogram-v4",
        "input": {
            "prompt": prompt,
            "rendering_speed": rendering_speed,
            "aspect_ratio": aspect_ratio,
        },
    }
    resp = requests.post(
        BASE_URL,
        headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
        json=payload,
    )
    resp.raise_for_status()
    return resp.json()["data"]["taskId"]

def wait_for_result(task_id, timeout_s=300, poll_interval=5):
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        data = requests.get(
            f"{BASE_URL}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        ).json()["data"]
        if data["status"] == "success":
            return data["output"][0]["url"]
        if data["status"] == "fail":
            raise RuntimeError(f"task {task_id} failed: {data.get('error')}")
        time.sleep(poll_interval)
    raise TimeoutError(f"task {task_id} did not finish in {timeout_s}s")

def run_batch(csv_path):
    os.makedirs(OUT_DIR, exist_ok=True)
    with open(csv_path, newline="", encoding="utf-8") as f:
        reader = csv.DictReader(f)
        for row in reader:
            name = row["name"]
            prompt = row["prompt"]
            rendering_speed = row.get("rendering_speed") or "BALANCED"
            aspect_ratio = row.get("aspect_ratio") or "16:9"
            print(f"generating {name}...")
            task_id = create_task(prompt, rendering_speed, aspect_ratio)
            url = wait_for_result(task_id)
            image_bytes = requests.get(url, timeout=60).content
            with open(os.path.join(OUT_DIR, f"{name}.jpg"), "wb") as out:
                out.write(image_bytes)
            print(f"  saved {name}.jpg")

if __name__ == "__main__":
    run_batch("products.csv")

O products.csv só precisa das colunas name e prompt, e pode sobrescrever opcionalmente rendering_speed / aspect_ratio por linha:

name,prompt,rendering_speed,aspect_ratio
summer-sale-banner,"Bold headline ""SUMMER SALE"" on pastel gradient background",BALANCED,16:9
label-aurelia-cream,"Skincare jar label reading ""AURELIA"" and ""HYDRATING FACE CREAM""",BALANCED,1:1
flash-sale-24h,"Dark navy flash sale banner with ""24 HOURS ONLY"" and a ""-50%"" price tag",BALANCED,16:9

Deixe-o rodar durante a noite sobre uma lista inteira de produtos ou campanhas e depois revise em lote a pasta de saída antes de publicar qualquer coisa — a etapa de revisão não desaparece só porque a geração foi feita em lote.

Dicas de prompt para obter tipografia limpa

Os seguintes padrões se confirmaram nas três imagens de teste:

• Coloque o texto exato entre aspas. No prompt, coloque entre aspas o texto literal que deseja renderizar (por exemplo, text "SUMMER SALE"), em vez de descrevê-lo indiretamente. Esse é o maior fator isolado para obter o texto exato de volta.
• Separe explicitamente título e subtítulo. Descrever as duas linhas como duas instruções distintas ("título principal em negrito... abaixo dele um texto menor...") produziu uma hierarquia mais clara do que uma única frase longa e contínua.
• Peça contraste, não apenas cor. Combinações de fundo e primeiro plano com alto contraste (azul-marinho escuro + vermelho-alaranjado, pastel + texto escuro) renderizaram consistentemente glifos mais nítidos do que esquemas de baixo contraste.
• Defina explicitamente o espaço negativo. Se você precisa que o texto fique em uma área específica, diga isso ("deixe bastante espaço negativo no lado esquerdo para o texto") — caso contrário, o modelo fica livre para posicionar o texto onde julgar melhor para a composição, o que pode não ser onde seu layout precisa.
• Mantenha o texto do rótulo curto. Mockups de rótulos curvos são o layout menos tolerante a texto; nomes de marca curtos e subtítulos curtos passaram pela revisão com muito mais frequência do que um parágrafo inteiro de texto de embalagem.

Perguntas frequentes

O Ideogram V4 consegue editar fotos de produtos existentes em vez de gerar novos banners? Não — ele é apenas texto-para-imagem, sem entrada de imagem para imagem. Se você precisa colocar texto sobre fotos de produtos existentes, gere os elementos de texto separadamente ou use um modelo compatível com i2i nessa etapa.

O Ideogram V4 oferece suporte a proporções verticais ou quadradas para posts de Instagram/redes sociais? Sim — além de 16:9, o aspect_ratio também aceita valores como 9:16 e 1:1, então a mesma abordagem de prompt também funciona para cards de produto quadrados ou banners sociais verticais.

Qual rendering_speed usar por padrão em execuções em lote de um catálogo real de produtos? BALANCED — todos os exemplos deste guia usam esse nível, e ele é confiável o suficiente para banners e rótulos padrão. Reserve o QUALITY para peças visuais principais grandes e use o TURBO enquanto ainda estiver ajustando o texto e precisar de iteração de baixo custo.

Se o texto geralmente é renderizado corretamente, ainda preciso revisar? Sim. A precisão de texto do Ideogram V4 é muito alta, mas não é garantida — trate cada gráfico gerado como uma prova de impressão: verifique antes de publicar, em vez de esperar que um cliente aponte o erro de digitação depois.

Pronto para gerar seu próprio catálogo de imagens? Obtenha uma chave de API e teste um prompt na página do modelo Ideogram V4, ou consulte o guia de início rápido da documentação da API hiapi se você for integrá-lo a uma esteira existente de catálogo de produtos. Se você ainda está comparando modelos especificamente para fotografia de produto (e não gráficos com muito texto), Best AI Models for E-Commerce Product Images detalha a comparação entre o Ideogram V4 e opções voltadas para foto, enquanto Building an E-Commerce Product Image Workflow With GPT Image 2 cobre o padrão de esteira em lote no qual o script deste guia se baseia.