
Deve passar 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 até 2048×2048 em área desce de 44 créditos ($0.22) no ideogram-v4.5 para 20 créditos ($0.10) no ideogram-v4.6, menos 55%, e ganha tamanhos personalizados até 4096 píxeis por lado. Para edições de imagens de origem grandes, a decisão é menos simples, porque o Ideogram 4.6 acrescenta um escalão de preço 4K que o Ideogram 4.5 não tinha. Este artigo enumera todas as diferenças no pedido e o preço do mesmo pedido em ambas as versões.
O que mudou, segundo a Ideogram
A Ideogram descreve o 4.5 como funcionando «em quatro modos de qualidade em 2K nativo» e diz que o 4.6 «gera imagens em 4K nativo», chamando-lhe «o nosso modelo de edição mais preciso até hoje». 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 de uma marca) | 83% | 46% |
| Detalhe de produto (reparar um pequeno defeito) | 86% | 61% |
| Fotografias de produto (encenar, mudar o estilo, reetiquetar) | 88% | 66% |
| Consistência de personagem | 85% | 69% |
| Edições com máscara (alterar apenas a área pintada) | 90% | 82% |
A Ideogram indica também 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. Estes números são da Ideogram; a PoYo não fez um teste lado a lado das duas versões.
Diferenças no pedido da Ideogram 4.6 API, campo a campo
Ambas as 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 carateres | Igual |
n | De 1 a 8 | Igual |
size predefinido em text-to-image | 1:1 HD | auto (o modelo escolhe cerca de 2K) |
| Tamanhos de text-to-image | 6 predefinições ou um de 36 tamanhos listados | 6 predefinições, 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 | Acrescenta very_low (saídas até 4,194,304 píxeis) |
| Tamanhos personalizados na edição | Múltiplos de 32, no máximo 4,194,304 píxeis no total | Múltiplos de 32, até 4096 por lado |
background | Não consta do esquema | transparent ou opaque (text-to-image e edições normais) |
seed | Não consta do esquema | De 0 a 2,147,483,647 |
image_urls (edição) | Exatamente uma imagem | Igual |
reference_image_urls (edição) | De 0 a 4, no máximo 3 com máscara | Igual |
mask_url (edição) | Exige size: auto | Igual |
edit_precision (edição) | regular ou high; high exige size: auto | Igual, e high rejeita background |
context_window (edição) | Não disponível | none ou auto; auto edita apenas a região à volta da máscara, à resolução da origem |
A expansão do prompt está sempre ativa em ambas as versões. No 4.6, os campos desconhecidos são rejeitados com um erro unsupported fields, por isso remova tudo o que o seu código do 4.5 acrescentava para além do esquema documentado.
Seis tamanhos do 4.5 que o 4.6 rejeita
O Ideogram 4.6 exige que ambos os 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 a usar em alternativa |
|---|---|---|
1280x720 | 720 não é múltiplo de 32 | 1536x864 (16:9) ou a predefinição 16:9 |
720x1280 | Igual | 864x1536 (9:16) ou a predefinição 9:16 |
1440x720 | 720 | 1408x704 (2:1) |
720x1440 | 720 | 704x1408 (1:2) |
1296x3168 | 1296 e 3168 | 1280x3136 |
3168x1296 | Igual | 3136x1280 |
Os outros 30 tamanhos listados passam sem alterações.
Preço do mesmo pedido
Todos os preços são da PoYo, por imagem de saída. 1 crédito = $0.005. O Ideogram 4.5 tinha um único preço por qualidade; o Ideogram 4.6 divide cada qualidade em 2K (até 4,194,304 píxeis) e 4K (acima disso).
Text-to-image
| Pedido | 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 píxeis | 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 píxeis, por isso cada pedido text-to-image do 4.5 corresponde a um preço 2K do 4.6 igual ou inferior. Uma imagem high 4K no 4.6 (40 créditos) continua a custar menos do que uma imagem high 2K no 4.5 (44 créditos).
Edição
| Pedido | ideogram-v4.5-edit | ideogram-v4.6-edit |
|---|---|---|
very_low, origem até 4,194,304 píxeis | 1.6 créditos ($0.008) | 1.6 créditos ($0.008) |
low / medium / high, saída até 4,194,304 píxeis | 6 / 12 / 44 créditos | 6 / 12 / 44 créditos |
low, saída acima de 4,194,304 píxeis | 6 créditos ($0.03) | 12 créditos ($0.06) |
medium, saída acima de 4,194,304 píxeis | 12 créditos ($0.06) | 40 créditos ($0.20) |
high, saída acima de 4,194,304 píxeis | 44 créditos ($0.22) | 120 créditos ($0.60) |
Este é o único caso em que o 4.6 custa mais. Com size: auto, uma edição mantém a geometria da origem, por isso uma edição de alta precisão de uma fotografia grande ou de um cartaz 4K cai no escalão 4K. O 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 e qualidade high de um cartaz de 2304×3072, a tarefa 672JRU198S22NS8D, foi cobrada a 120 créditos ($0.60). Alterou apenas a linha da data; todos os píxeis alterados ficaram dentro de uma única caixa que cobria cerca de 1.1% da imagem.
Se edita origens grandes e não precisa do resultado em tamanho completo, reduza a origem para 4,194,304 píxeis ou menos antes de a enviar. A edição passa então para o escalão 2K, com o mesmo preço do 4.5.
Quando mudar
| Carga de trabalho | Recomendação |
|---|---|
| Text-to-image em qualquer qualidade | Mude já. Preço igual ou inferior, mais very_low, tamanhos personalizados, background e seed. |
| Cartazes e impressão acima de 2048×2048 em área | Mude. O 4.5 não os conseguia produzir. |
| Edições de origens até 4,194,304 píxeis | Mude. Mesmo preço, mais os ganhos de precisão indicados pela Ideogram. |
Edições de origens grandes em medium ou high | Teste primeiro. O preço sobe para 40 ou 120 créditos; compare o resultado com uma edição 2K de uma origem reduzida. |
| Correções com máscara em 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, altere o ID de modelo e, se dependia da antiga predefinição, 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 devolve uma imagem maior, de cerca de 2K, ainda ao preço 2K. Para as edições, o ID de modelo é a única alteração 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 pedido, e a análise de preços cobre os orçamentos de cada escalão.
Perguntas frequentes
A Ideogram 4.6 API é mais barata do que a Ideogram 4.5 API?
Em text-to-image na PoYo, sim ou igual: high desce de 44 para 20 créditos em 2K, e low e medium não mudam. As edições com saídas acima de 4,194,304 píxeis custam mais no 4.6.
Os pedidos à Ideogram 4.5 API funcionam sem alterações no Ideogram 4.6?
Na maioria dos casos. Altere 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 predefinido de text-to-image passa de 1:1 HD para auto.
A Ideogram 4.5 API consegue devolver imagens 4K? Não. Na PoYo, os tamanhos de text-to-image do 4.5 ficam pelos 4,194,304 píxeis. O Ideogram 4.6 vai até 4096 píxeis 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 à volta da máscara é editada e a resolução da origem é mantida.
O Ideogram 4.5 continua disponível na PoYo?
Sim, ideogram-v4.5 e ideogram-v4.5-edit continuam listados na página do modelo Ideogram 4.5.