
A Ideogram 4.6 API dá acesso ao modelo de imagem mais recente da Ideogram através de um único endpoint REST na PoYo: ideogram-v4.6 para text-to-image e ideogram-v4.6-edit para editar uma imagem de origem com uma máscara e imagens de referência opcionais. As saídas chegam a 4096 píxeis por lado, os preços começam em 1.6 créditos ($0.008) por imagem e todos os pedidos usam a mesma API key que o resto da PoYo. Esta página explica o que é o Ideogram 4.6, os limites exatos, os escalões de preço e o que medimos no dia do lançamento.
O que é o Ideogram 4.6?
O Ideogram 4.6 é um modelo de geração e edição de imagens da Ideogram, lançado a 19 de novembro de 2026. A Ideogram chama-lhe «o nosso modelo de edição mais preciso até hoje» e afirma que «gera imagens em 4K nativo», «sem upscaling». Na sua página do modelo, a Ideogram diz também que o modelo «deixa muito menos desvio de píxeis fora das suas edições e mantém a cor com mais precisão».
A Ideogram sustenta isto com pontuações por tarefa em qualidade alta, comparando o 4.6 com o 4.5:
| Tarefa (descrição da Ideogram) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| Cor exata: recolorir um objeto com o código hex de uma marca | 83% | 46% |
| Detalhe de produto: reparar um pequeno defeito numa fotografia de produto | 86% | 61% |
| Fotografias de produto: encenar, mudar o estilo e reetiquetar produtos | 88% | 66% |
| Consistência de personagem: manter uma pessoa reconhecível numa cena nova | 85% | 69% |
| Edições com máscara: alterar apenas a área pintada | 90% | 82% |
Estes são números da Ideogram, não medições da PoYo. Numa integração por API, apontam para três tipos de pedidos que vale a pena enviar aqui:
- Cartazes, rótulos e gráficos para redes sociais com palavras exatas: coloque o texto entre aspas no prompt.
- Edições que têm de deixar tudo o resto intacto: uma data nova num folheto, um produto recolorido, um único detalhe alterado.
- Impressões de grande dimensão: tamanhos personalizados até 4096 píxeis por lado, sem um passo de upscaling à parte.
A Ideogram 4.6 API em resumo
| Text-to-image | Edição | |
|---|---|---|
| ID de modelo na PoYo | ideogram-v4.6 | ideogram-v4.6-edit |
| Endpoint de submissão | POST https://api.poyo.ai/api/generate/submit | O mesmo |
| Resultado | Consulte GET /api/generate/status/{task_id} ou use callback_url | Igual |
| Entradas | prompt | prompt + exatamente uma imagem em image_urls, mask_url e reference_image_urls opcionais |
| Imagens por pedido | 1 a 8 (n) | 1 a 8 (n) |
| Níveis de qualidade | very_low, low, medium (predefinição), high | Os mesmos |
| Lançamento da Ideogram | 19 de novembro de 2026 | 19 de novembro de 2026 |
| Documentação | Referência da Ideogram V4.6 API | Referência do Ideogram V4.6 Edit |
Os dois IDs partilham autenticação, polling e faturação, por isso uma aplicação pode gerar com um e refinar com o outro sem uma segunda integração.
Limites e campos do pedido
| Campo | Regra na PoYo |
|---|---|
prompt | Obrigatório, de 1 a 10,000 carateres, tem de conter texto que não seja só espaços. Coloque entre aspas o texto exato que deve aparecer na imagem. |
size | auto (predefinição), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16 ou um WIDTHxHEIGHT personalizado |
| Tamanho personalizado | x minúsculo, ambos os lados de 256 a 4096 píxeis e múltiplos de 32, proporção entre 1:6 e 6:1 |
quality | very_low, low, medium (predefinição), high; very_low só até 4,194,304 píxeis |
n | Inteiro de 1 a 8 |
background | transparent ou opaque; apenas text-to-image e edições normais |
seed | Inteiro de 0 a 2,147,483,647 |
image_urls (edição) | Exatamente uma imagem de origem, URL HTTP(S) público ou data URI em base64, sempre como array |
mask_url (edição) | Mesmas dimensões que a origem; o preto é editado, o branco é mantido; exige size: auto |
reference_image_urls (edição) | De 0 a 4 imagens, ou no máximo 3 com máscara |
edit_precision (edição) | regular (predefinição) ou high; high exige size: auto e rejeita background |
context_window (edição) | none (predefinição) ou auto; auto exige mask_url e edit_precision: high |
Qualquer outro campo dentro de input é rejeitado com um erro unsupported fields. Os ficheiros gerados ficam disponíveis durante 3 dias, por isso copie-os para o seu próprio armazenamento.
Preços da Ideogram 4.6 API
A PoYo fatura por imagem de saída, consoante a qualidade e o escalão de tamanho. «2K» significa uma saída até 4,194,304 píxeis (2048×2048 em área); tudo o que for maior é «4K». 1 crédito = $0.005.
| Qualidade | Text-to-image 2K | Text-to-image 4K | Edição 2K | Edição 4K |
|---|---|---|---|---|
very_low | 1.6 créditos ($0.008) | não disponível | 1.6 créditos ($0.008) | não disponível |
low | 6 créditos ($0.03) | 12 créditos ($0.06) | 6 créditos ($0.03) | 12 créditos ($0.06) |
medium | 12 créditos ($0.06) | 24 créditos ($0.12) | 12 créditos ($0.06) | 40 créditos ($0.20) |
high | 20 créditos ($0.10) | 40 créditos ($0.20) | 44 créditos ($0.22) | 120 créditos ($0.60) |
size: auto e as seis predefinições são sempre 2K em text-to-image. Nas edições com size: auto, a saída mantém a geometria da origem, pelo que uma origem grande cai no escalão 4K. Estes preços coincidem com a tabela por imagem da página do modelo da Ideogram; a análise de preços aplica-os a pedidos reais.
O que medimos no dia do lançamento
A equipa da PoYo executou estes testes na API de produção da PoYo a 20 de novembro de 2026. O prompt era um cartaz serigrafado de "NORTHBOUND JAZZ FESTIVAL" com as linhas "JUNE 12-14 · RIVERSIDE PARK" e "Three nights. Twenty-one bands. Free entry before 6 PM."
| Tarefa | Pedido | Saída | Cobrado |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | Um PNG de 2304×3072, cerca de 10.8 MB | 40 créditos ($0.20) |
BS7M64COKT80JSLX | Mesmo prompt, quality: very_low, size: 3:4 | PNG de 768×1024 | 1.6 créditos ($0.008) |
672JRU198S22NS8D | ideogram-v4.6-edit sobre o primeiro cartaz, edit_precision: high, context_window: none, size: auto, quality: high | PNG de 2304×3072 | 120 créditos ($0.60) |
Todo o texto dos dois primeiros cartazes saiu tal como estava escrito, incluindo a pequena linha em itálico; o rascunho tinha uma composição diferente. O prompt de edição foi: Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. Uma comparação de píxeis com o original encontrou todos os píxeis alterados dentro de uma única caixa, de (471, 2699) a (1826, 2756), cerca de 1.1% da imagem; o resto ficou inalterado. A edição usou o escalão 4K de qualidade alta porque uma edição de alta precisão mantém a resolução da origem. O guia de texto e edições precisas percorre esse pedido passo a passo.
O seu primeiro pedido à Ideogram 4.6 API
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.6",
"input": {
"prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
"size": "2048x3072",
"quality": "high",
"n": 2
}
}'
2048x3072 são 6,291,456 píxeis, por isso este pedido é faturado à tarifa 4K de qualidade alta: 2 × 40 = 80 créditos ($0.40). A resposta traz data.task_id com o estado not_started. Consulte o endpoint de estado até ser finished e leia as imagens em data.files, ou passe um callback_url no nível superior. Verifique sempre o code no corpo: alguns erros de validação devolvem HTTP 200 com code: 400. O guia da API inclui um ciclo de polling em Python com limite de tempo e um corpo para cada modo de entrada.
Onde o Ideogram 4.6 está disponível
A Ideogram disponibiliza o 4.6 na sua própria aplicação e API, com dois endpoints: Generate e Precise Edit. Na PoYo chama-o com a mesma chave que usa para todos os outros modelos, o mesmo fluxo de tarefas e callbacks, e um Playground na página do modelo que mostra o preço antes de cada execução. Na PoYo, as imagens de referência passam por ideogram-v4.6-edit; o ID de text-to-image aceita apenas um prompt e os controlos de tamanho, qualidade, n, background e seed.
Que pedidos enviar para cada modelo
| Pedido | ID de modelo e definições |
|---|---|
| Rascunhos e exploração de layout | ideogram-v4.6, very_low ou low, um tamanho predefinido, n até 8 |
| Cartazes finais e gráficos para redes sociais até 2048×2048 em área | ideogram-v4.6, high, tamanho personalizado como 1728x2304 |
| Impressão e arte de grande formato | ideogram-v4.6, de low a high, tamanho personalizado acima de 4,194,304 píxeis |
| Alterar um detalhe e manter o resto | ideogram-v4.6-edit, edit_precision: high |
| Repintar uma região de uma imagem grande | ideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto |
| Mudar o estilo com uma referência, novo tamanho de saída | ideogram-v4.6-edit, edit_precision: regular, reference_image_urls, size personalizado |
Vem do Ideogram 4.5? A comparação 4.6 vs 4.5 enumera as alterações de campos, as novas regras de tamanho e o preço do mesmo pedido. Se está a avaliar outras APIs de imagem na PoYo, consulte a apresentação da MAI Image 2.7 API e a comparação Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Perguntas frequentes
Qual é o ID de modelo da Ideogram 4.6 API?
Use ideogram-v4.6 para text-to-image e ideogram-v4.6-edit para edição. ideogram-4-6 é apenas o slug da página na PoYo e não é um ID de modelo.
Quanto custa a Ideogram 4.6 API?
A partir de 1.6 créditos ($0.008) por imagem em very_low 2K. Uma imagem medium 2K predefinida custa 12 créditos ($0.06), e high custa 20 créditos ($0.10) em 2K e 40 créditos ($0.20) em 4K. As edições 4K de qualidade alta custam 120 créditos ($0.60).
Qual é a maior imagem que a Ideogram 4.6 API consegue devolver? Os tamanhos personalizados vão até 4096 píxeis por lado, em múltiplos de 32, com uma proporção entre 1:6 e 6:1. Tudo o que ultrapasse 4,194,304 píxeis é faturado no escalão 4K.
A Ideogram 4.6 API renderiza texto nas imagens? Sim, coloque as palavras exatas entre aspas no prompt. No nosso teste do lançamento, um cartaz de 2304×3072 apresentou o título, a linha da data e uma pequena linha em itálico tal como estavam escritos. Ainda assim, a Ideogram aconselha a verificar a ortografia e o posicionamento no resultado final.
A Ideogram 4.6 API pode devolver imagens transparentes?
Sim. Defina background como transparent para text-to-image ou edições normais. As edições de alta precisão rejeitam background.
A Ideogram 4.6 API é compatível com o SDK da OpenAI?
Não. É uma API de tarefas assíncronas: submeta para /api/generate/submit e depois consulte /api/generate/status/{task_id} ou receba um callback.