
Vale a pena migrar da Ideogram 4.5 API para a Ideogram 4.6 API? Para text-to-image na PoYo, a resposta é sim: uma imagem de qualidade high de até 2048×2048 de área cai de 44 créditos ($0.22) no ideogram-v4.5 para 20 créditos ($0.10) no ideogram-v4.6, 55% a menos, e você ganha tamanhos personalizados de até 4096 pixels por lado. Para edições de imagens de origem grandes, a decisão é menos simples, porque o Ideogram 4.6 adiciona uma faixa de preço 4K que o Ideogram 4.5 não tinha. Este post lista todas as diferenças de requisição e o preço da mesma requisição nas duas versões.
O que mudou, segundo a Ideogram
A Ideogram descreve o 4.5 como rodando "em quatro modos de qualidade em 2K nativo" e diz que o 4.6 "gera imagens em 4K nativo", chamando-o de "nosso modelo de edição mais preciso até agora". A sua página do modelo 4.6 compara os dois em qualidade alta:
| Tarefa | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| Cor exata (recolorir com o código hex da marca) | 83% | 46% |
| Detalhe de produto (corrigir um pequeno defeito) | 86% | 61% |
| Fotos de produto (montar a cena, mudar o estilo, trocar o rótulo) | 88% | 66% |
| Consistência de personagem | 85% | 69% |
| Edições com máscara (alterar só a área pintada) | 90% | 82% |
A Ideogram também informa uma pontuação Rapidata Multi-step Image Edit de 1,892 (±32) para o 4.6 e de 1,866 (±30) para o 4.5. Esses números são da Ideogram; a PoYo não fez um teste lado a lado das duas versões.
Diferenças de requisição entre a Ideogram 4.5 API e a Ideogram 4.6 API, campo a campo
As duas versões usam o mesmo endpoint, POST https://api.poyo.ai/api/generate/submit, o mesmo polling de tarefas e o mesmo callback_url. O que muda está dentro de input.
| Campo | Ideogram 4.5 API | Ideogram 4.6 API |
|---|---|---|
| IDs de modelo | ideogram-v4.5, ideogram-v4.5-edit | ideogram-v4.6, ideogram-v4.6-edit |
prompt | De 1 a 10,000 caracteres | O mesmo |
n | De 1 a 8 | O mesmo |
size padrão em text-to-image | 1:1 HD | auto (o modelo escolhe cerca de 2K) |
| Tamanhos em text-to-image | 6 presets ou um de 36 tamanhos listados | 6 presets, auto ou qualquer WIDTHxHEIGHT de 256 a 4096 por lado, múltiplos de 32, proporção entre 1:6 e 6:1 |
quality em text-to-image | low, medium, high | Adiciona very_low (saídas de até 4,194,304 pixels) |
| Tamanhos personalizados na edição | Múltiplos de 32, no máximo 4,194,304 pixels no total | Múltiplos de 32, até 4096 por lado |
background | Não está no schema | transparent ou opaque (text-to-image e edições regulares) |
seed | Não está no schema | De 0 a 2,147,483,647 |
image_urls (edição) | Exatamente uma imagem | O mesmo |
reference_image_urls (edição) | De 0 a 4, no máximo 3 com máscara | O mesmo |
mask_url (edição) | Exige size: auto | O mesmo |
edit_precision (edição) | regular ou high; high exige size: auto | O mesmo, e high rejeita background |
context_window (edição) | Não disponível | none ou auto; auto edita só a região em volta da máscara na resolução da origem |
A expansão do prompt está sempre ativa nas duas versões. Campos desconhecidos são rejeitados no 4.6 com um erro unsupported fields, então remova tudo o que o seu código do 4.5 adicionava além do schema documentado.
Seis tamanhos do 4.5 que o 4.6 rejeita
O Ideogram 4.6 exige que os dois lados sejam múltiplos de 32. Seis tamanhos da lista do 4.5 não cumprem essa regra:
| Tamanho do 4.5 | Problema | Tamanho do 4.6 para usar no lugar |
|---|---|---|
1280x720 | 720 não é múltiplo de 32 | 1536x864 (16:9) ou o preset 16:9 |
720x1280 | O mesmo | 864x1536 (9:16) ou o preset 9:16 |
1440x720 | 720 | 1408x704 (2:1) |
720x1440 | 720 | 704x1408 (1:2) |
1296x3168 | 1296 e 3168 | 1280x3136 |
3168x1296 | O mesmo | 3136x1280 |
Os outros 30 tamanhos listados passam sem alterações.
Preço da mesma requisição
Todos os preços são da PoYo, por imagem de saída. 1 crédito = $0.005. O Ideogram 4.5 tinha um preço por qualidade; o Ideogram 4.6 divide cada qualidade em 2K (até 4,194,304 pixels) e 4K (acima disso).
Text-to-image
| Requisição | ideogram-v4.5 | ideogram-v4.6 |
|---|---|---|
very_low, qualquer tamanho 2K | não disponível | 1.6 créditos ($0.008) |
low, 2K | 6 créditos ($0.03) | 6 créditos ($0.03) |
medium, 2K | 12 créditos ($0.06) | 12 créditos ($0.06) |
high, 2K | 44 créditos ($0.22) | 20 créditos ($0.10) |
low / medium / high acima de 4,194,304 pixels | não disponível | 12 / 24 / 40 créditos ($0.06 / $0.12 / $0.20) |
Todos os tamanhos que o 4.5 oferecia têm no máximo 4,194,304 pixels, então toda requisição text-to-image do 4.5 corresponde a um preço 2K do 4.6 igual ou menor. Uma imagem high em 4K no 4.6 (40 créditos) ainda custa menos que uma imagem high em 2K no 4.5 (44 créditos).
Edição
| Requisição | ideogram-v4.5-edit | ideogram-v4.6-edit |
|---|---|---|
very_low, origem de até 4,194,304 pixels | 1.6 créditos ($0.008) | 1.6 créditos ($0.008) |
low / medium / high, saída de até 4,194,304 pixels | 6 / 12 / 44 créditos | 6 / 12 / 44 créditos |
low, saída acima de 4,194,304 pixels | 6 créditos ($0.03) | 12 créditos ($0.06) |
medium, saída acima de 4,194,304 pixels | 12 créditos ($0.06) | 40 créditos ($0.20) |
high, saída acima de 4,194,304 pixels | 44 créditos ($0.22) | 120 créditos ($0.60) |
Este é o único ponto em que o 4.6 custa mais. Com size: auto, uma edição mantém a geometria da origem, então uma edição de alta precisão de uma foto grande ou de um pôster 4K cai na faixa 4K. Nosso teste do dia do lançamento (API de produção da PoYo, 20 de novembro de 2026) é um exemplo direto: uma edição de alta precisão, em qualidade high, de um pôster de 2304×3072, tarefa 672JRU198S22NS8D, foi cobrada em 120 créditos ($0.60). Ela alterou apenas a linha da data; todos os pixels alterados ficaram em uma única caixa que cobria cerca de 1.1% da imagem.
Se você edita origens grandes e não precisa do resultado em tamanho completo, reduza a origem para 4,194,304 pixels ou menos antes de enviá-la. A edição passa então a ser cobrada na faixa 2K, igual ao 4.5.
Quando migrar
| Carga de trabalho | Recomendação |
|---|---|
| Text-to-image em qualquer qualidade | Migre agora. Preço igual ou menor, mais very_low, tamanhos personalizados, background e seed. |
| Pôsteres e impressão acima de 2048×2048 de área | Migre. O 4.5 não conseguia produzi-los. |
| Edições de origens de até 4,194,304 pixels | Migre. Mesmo preço, mais os ganhos de precisão informados pela Ideogram. |
Edições de origens grandes em medium ou high | Teste antes. O preço sobe para 40 ou 120 créditos; compare o resultado com uma edição 2K a partir de uma origem reduzida. |
| Correções com máscara dentro de imagens muito grandes | Experimente context_window: auto, novo no 4.6, que mantém a resolução da origem fora da região editada. |
Diff de migração
Para text-to-image, troque o ID de modelo e, se você dependia do padrão antigo, defina size explicitamente:
{
- "model": "ideogram-v4.5",
+ "model": "ideogram-v4.6",
"input": {
"prompt": "A ceramic robot with a clean silhouette.",
- "quality": "high"
+ "quality": "high",
+ "size": "1:1 HD"
}
}
Sem "size": "1:1 HD", o 4.6 usa auto e retorna uma imagem maior, de cerca de 2K, ainda pelo preço 2K. Para edições, o ID de modelo é a única mudança obrigatória; context_window é opcional:
{
- "model": "ideogram-v4.5-edit",
+ "model": "ideogram-v4.6-edit",
"input": {
"prompt": "Replace the black mask area with flowers.",
"image_urls": ["https://example.com/source.png"],
"mask_url": "https://example.com/mask.png",
"reference_image_urls": ["https://example.com/flowers.png"],
- "edit_precision": "high"
+ "edit_precision": "high",
+ "context_window": "auto"
}
}
O guia da Ideogram 4.6 API tem o conjunto completo de corpos de requisição, e o detalhamento de preços cobre orçamentos para cada faixa.
Perguntas frequentes
A Ideogram 4.6 API é mais barata que a Ideogram 4.5 API?
Em text-to-image na PoYo, é mais barata ou igual: high cai de 44 para 20 créditos em 2K, e low e medium não mudam. Edições com saídas acima de 4,194,304 pixels custam mais no 4.6.
As requisições da Ideogram 4.5 API funcionam no Ideogram 4.6 sem alterações?
Em grande parte. Troque o ID de modelo. Seis tamanhos listados do 4.5 que não são múltiplos de 32, como 1296x3168, são rejeitados, e o tamanho padrão em text-to-image muda de 1:1 HD para auto.
A Ideogram 4.5 API pode retornar imagens em 4K? Não. Na PoYo, os tamanhos de text-to-image do 4.5 param em 4,194,304 pixels. O Ideogram 4.6 vai até 4096 pixels por lado.
O que é context_window na Ideogram 4.6 API?
Uma opção de edição. Com auto, uma máscara e edit_precision: high, só a região em volta da máscara é editada e a resolução da origem é mantida.
O Ideogram 4.5 ainda está disponível na PoYo?
Sim, ideogram-v4.5 e ideogram-v4.5-edit continuam listados na página do modelo Ideogram 4.5.