Receitas de prompts do Ideogram v4.5: prompts de tipografia prontos para copiar e colar, com saídas reais

A maioria dos modelos de imagem consegue desenhar um pôster bonito, mas erra a grafia do título. Toda a reputação do Ideogram é o oposto: ele acerta as letras. ideogram-v4.5/text-to-image é o modelo de texto-para-imagem mais recente do Ideogram no hiapi, e como todos os outros modelos, roda na API unificada de tarefas. Esta página é uma biblioteca de prompts que você pode usar diretamente — seis receitas, cobrindo logo, pôster, banner e embalagem, cada uma com o prompt que eu realmente enviei e a imagem que ele realmente retornou. Toda saída abaixo foi gerada com ideogram-v4.5/text-to-image no hiapi; nenhuma é material de banco de imagens e nenhuma passou por retoque.

Ela também responde a uma pergunta que essas receitas levantam repetidamente: o nível quality. O v4.5 cobra em três níveis — low, medium e high — com diferença de preço considerável, então rodei o mesmo prompt e a mesma seed nos três níveis e comparei a renderização real do texto. O resultado não é o que você imagina; veja os detalhes na seção sobre os níveis de qualidade abaixo.

Escopo: aqui é o endpoint básico de texto para imagem. O v4.5 também tem uma rota separada de imagem para imagem/edição (ideogram-v4.5/image-to-image), que suporta máscaras e imagens de referência — esse é outro schema, tratado em outro artigo.

O schema que o v4.5 realmente aceita (menos do que você imagina)

Antes de ver as receitas, vale falar do contrato de entrada — porque a superfície da interface do v4.5 não é a mesma do ideogram-v4. Testei campo a campo contra a API em produção. Tudo o que é necessário são apenas estes cinco:

Campo	Tipo	Descrição
prompt	string, obrigatório	Coloque o texto a renderizar entre aspas duplas (veja a próxima seção).
quality	low / medium / high	Nível de preço. O comportamento padrão equivale a medium.
num_images	inteiro 1–8	Uma tarefa pode retornar um conjunto inteiro de imagens.
seed	inteiro	Fixe-a para comparar dois prompts (ou dois níveis) de forma justa.
image_size	enum	Um destes valores: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.

O que me surpreendeu: não existe campo aspect_ratio nem resolution. O v4 aceita string aspect_ratio e rendering_speed; o v4.5 removeu os dois. Você só pode escolher uma forma entre seis presets de image_size, e esse é o único controle de tamanho — a API rejeita diretamente aspect_ratio, resolution, rendering_speed, magic_prompt, style_type e negative_prompt com additional properties not allowed. Então, se você está migrando de requisições do v4, remova esses campos ou cada chamada retornará 400.

Os preços vêm da página de preços em produção do hiapi, cobrados por imagem e variando conforme o nível:

quality	Preço por imagem
low	$0.043
medium	$0.086
high	$0.3145

Abaixo está a requisição mínima — cria a tarefa e depois consulta até a conclusão:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram-v4.5/text-to-image",
    "input": {
      "prompt": "A clean wordmark logo, the text \"NORTHWIND ROASTERS\" in an elegant high-contrast serif, cream background, centered",
      "quality": "medium",
      "image_size": "square",
      "num_images": 1
    }
  }'
# -> {"data":{"taskId":"tk-..."}}

import os, time, requests

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

task = requests.post(BASE, headers=H, json={
    "model": "ideogram-v4.5/text-to-image",
    "input": {
        "prompt": 'A clean wordmark logo, the text "NORTHWIND ROASTERS" '
                  'in an elegant high-contrast serif, cream background, centered',
        "quality": "medium",
        "image_size": "square",
        "num_images": 1,
    },
}).json()
tid = task["data"]["taskId"]

while True:                                   # poll to a terminal state
    d = requests.get(f"{BASE}/{tid}", headers=H).json()["data"]
    if d["status"] in ("success", "fail"):
        break
    time.sleep(5)

print(d["output"][0]["url"])                  # temp URL — download it right away

output[0].url é um link temporário que expira em cerca de uma semana, então baixe os bytes imediatamente — não faça hotlink dele em produção.

A única regra que decide o sucesso de cada receita

Tudo abaixo se baseia em um hábito: coloque o texto exato que você quer renderizar entre aspas duplas e não deixe o texto que importa para você ser inventado pelo modelo.

O Ideogram expande seu prompt. Pedir um pôster de festival de música, ele adiciona de bom grado o lineup, as datas e os preços que você nunca escreveu — ótimo para mockups realistas, mas arriscado se esses detalhes precisarem estar corretos. Nos testes, toda string curta que eu coloquei entre aspas saiu com a grafia perfeita; é no texto que o modelo inventa por conta própria que os erros de digitação aparecem. Então: coloque entre aspas nomes de marca, títulos, texto de botão e datas. Deixe o preenchimento decorativo com o modelo só quando você não se importar com o que ele disser.

Dominada essa regra, aqui estão as receitas.

Receita 1 — logo com wordmark

A clean minimalist wordmark logo for a specialty coffee brand, the text "NORTHWIND ROASTERS" set in an elegant high-contrast serif, a small compass-rose icon integrated above the letter N, warm cream background, centered, flat vector-style design, generous negative space

image_size: square · quality: medium

“NORTHWIND ROASTERS” saiu exatamente correto, a fonte serifada é realmente elegante e o espaço negativo parece o logo de uma marca real. Duas observações honestas: o modelo colocou a rosa dos ventos centralizada acima do wordmark inteiro, não “acima da letra N” — o v4.5 trata instruções espaciais como sugestões, não como coordenadas — e ele acrescentou por conta própria um slogan que eu nunca pedi, “SPECIALTY COFFEE · EST. 2019”. Essa expansão é o comportamento descrito pela regra acima: aqui é conveniente, mas se o seu slogan real for diferente, escreva-o explicitamente entre aspas em vez de deixar o modelo adivinhar.

Receita 2 — pôster de evento

A vertical concert poster for an indie music festival, large headline text "ECHO VALLEY FEST" across the top, below it two lines reading "AUGUST 14-16" and "RIVERSIDE PARK", retro 1970s psychedelic palette of orange, magenta and teal, layered sunburst background, bold condensed type, high detail

image_size: portrait_4_3 · quality: medium

As três strings entre aspas — “ECHO VALLEY FEST”, “AUGUST 14-16” e “RIVERSIDE PARK” — saíram limpas, e a forma portrait_4_3 dá espaço para o título respirar. O modelo também preencheu por conta própria um lineup de bandas plausível e um rodapé “GATES 6PM · ALL AGES · $45 ADV / $60 DOOR”. Para um mockup de proposta isso é um presente; para um pôster real, reescreva essas linhas inventadas no prompt para que você possa controlá-las.

Receita 3 — banner de anúncio para redes sociais

A horizontal social media ad banner for a fitness app, left-aligned headline text "MOVE MORE." in heavy bold uppercase, a smaller line reading "Start your 7-day free trial", and a rounded call-to-action button with the text "GET THE APP", energetic gradient from lime green to deep blue, clean modern UI style

image_size: landscape_16_9 · quality: medium

Este é o melhor desempenho do v4.5: três strings curtas independentes — título, subtítulo e texto do botão — em papéis de UI distintos, todas com a grafia correta, inclusive o ponto final em “MOVE MORE.”. O preset landscape_16_9 é o que você deve usar quando precisar de um banner largo ou de uma miniatura. Texto curto, explícito e entre aspas é exatamente o que este modelo faz bem.

Receita 4 — rótulo de embalagem de produto

A product label for a bottle of artisanal hot sauce, brand name "EMBER & ASH" in a vintage woodcut serif, product line "SMOKED HABANERO" below it, a small badge reading "SMALL BATCH - 150ML", kraft-paper texture background with charcoal and ember-orange ink, symmetrical layout

image_size: square_hd · quality: medium

Embalagem é o teste de texto mais difícil — fonte pequena, caracteres especiais, selos — e o v4.5 passou nas partes principais. “EMBER & ASH” renderizou o símbolo & corretamente (um ponto clássico de falha), “SMOKED HABANERO” saiu limpo, e a pimenta habanero em estilo xilogravura é um toque de gênio não solicitado. O selo pequeno saiu do previsto: eu pedi “SMALL BATCH - 150ML” e recebi “SMALL BATCH · EST · 150ML” mais uma linha “BOTTLED IN SMALL BATCHES”. A lição do manual continua valendo — quanto menor a fonte, mais o modelo improvisa — então, para rótulos que vão para a gráfica, mantenha o texto minúsculo curto e confira cada renderização.

Teste prático dos níveis de qualidade: low vs medium vs high

Essas receitas rodaram com medium. Mas o v4.5 cobra $0.043 / $0.086 / $0.3145 por low / medium / high — uma diferença de 7 vezes para cima e para baixo — então vale saber o que o dinheiro compra. Rodei um prompt deliberadamente denso em texto (um pôster de infográfico cheio de informações) nos três níveis, usando a mesma seed, para que só quality mudasse:

A dense informational poster titled "CITY TRANSIT GUIDE" with three labeled columns headed "BUS", "METRO" and "TRAM", a short line of body text under each heading, clean Swiss grid layout, red and black ink on off-white paper, flat vector infographic style

low — $0.043

O layout e o título grande “CITY TRANSIT GUIDE” estão nítidos. Mas o modelo inventou um subtítulo e errou a grafia — “WINTER SCHHEDULE” com um H a mais — e ainda repetiu um selo de linha (“41” aparece duas vezes). O título entre aspas (BUS/METRO/TRAM) está correto; é no texto não citado que ele adicionou que o erro está.

medium — $0.086

Mesma seed, um nível acima, o subtítulo se corrigiu sozinho para “WINTER SCHEDULE”. Os três blocos de texto principal estão legíveis, e a navegação do rodapé (“TICKETS · ZONES · DELAYS · HELP”) está limpa. Ainda há uma pequena falha de legenda (“CENTRHL” em vez de “CENTRAL”), mas para um layout tão denso em texto, é claramente o mais limpo dos três.

high — $0.3145

Aqui está a parte contraintuitiva. O high renderiza as fontes de exibição — o título grande, os rótulos BUS/METRO/TRAM — com a maior nitidez dos três níveis. Mas os parágrafos densos de texto principal colapsam em um texto confiante e sem sentido (“Mari routes runt monen downtwing...”, “tith tixve stations across five...”). Com o preço 3,6 vezes maior que o medium, ele gera texto principal pior, não melhor, nesse layout.

A conclusão é prática, não uma desqualificação do modelo: o nível quality aumenta o refinamento com que o v4.5 renderiza a fonte que escolheu, mas não torna o modelo melhor em inventar longos blocos de texto que você não escreveu — no high, ele apenas inventa com mais refinamento, e também com mais erros. Então:

• Use medium como padrão. Para qualquer coisa com texto real, é o melhor equilíbrio, e corrige os erros de digitação que o low introduz.
• Reserve o high para trabalhos predominantemente com fontes grandes e específicas — logos, pôsteres com título de uma linha — onde a nitidez extra vale a pena e não há parágrafos para ele alucinar.
• low serve para rascunhos grosseiros e miniaturas, onde um erro de digitação isolado não importa.
• Independentemente do nível, nunca dependa do modelo para escrever longos blocos de texto principal. Coloque entre aspas o texto que precisa estar correto; o resto, trate como espaço reservado.

FAQ

Posso definir 1080×1920 ou um tamanho exato em pixels? Não. O t2i do v4.5 aceita apenas seis presets de image_size — square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Não há campo de largura/altura nem aspect_ratio. Escolha o preset mais próximo e recorte se precisar da proporção exata.

Qual é a diferença em relação ao ideogram-v4? O contrato de entrada é diferente. O v4 usa aspect_ratio mais rendering_speed (turbo/balanced/quality); o v4.5 substituiu ambos por presets de image_size e níveis de preço quality. Se você precisa do formato de requisição do v4, o guia prático do ideogram-v4 cobre isso, e se você ainda está escolhendo um modelo de tipografia, ideogram-v4 vs Nano Banana 2 pode ajudar.

Ele consegue editar uma imagem existente? Não neste endpoint. Texto para imagem é ideogram-v4.5/text-to-image; edição (edição por prompt, máscaras, imagem de referência) é uma rota separada, ideogram-v4.5/image-to-image.

O texto sempre sai correto? Strings curtas entre aspas — nomes de marca, títulos, texto de botão — são confiáveis em todas as receitas deste artigo. O texto longo que o modelo inventa sozinho não é; revise cada renderização, especialmente selos pequenos e legendas.

Como gerar variantes rapidamente? Em uma única tarefa, defina num_images até 8 para retornar um conjunto de uma vez, ou fixe a seed e mude uma palavra para comparar prompts em condições iguais.

Execute você mesmo estas receitas

Cada prompt acima pode ser copiado e colado diretamente — troque as strings entre aspas pela sua própria marca, título ou data e envie. Obtenha o schema atualizado na página do modelo ideogram-v4.5/text-to-image, abra a página de preços para escolher seu nível quality, e se esta for sua primeira chamada à API de tarefas, o quickstart orienta você a obter a chave e consultar sua primeira tarefa. Coloque seu texto entre aspas, use medium por padrão e revise cada renderização antes de publicar.