guides

Ideogram 4.6 API: o que é o Ideogram 4.6, preços, limites e edições 4K

Poyo.ai Team
10 min read
Share:

Ideogram 4.6 API na PoYo

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.6Ideogram 4.5
Cor exata: recolorir um objeto com o código hex de uma marca83%46%
Detalhe de produto: reparar um pequeno defeito numa fotografia de produto86%61%
Fotografias de produto: encenar, mudar o estilo e reetiquetar produtos88%66%
Consistência de personagem: manter uma pessoa reconhecível numa cena nova85%69%
Edições com máscara: alterar apenas a área pintada90%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-imageEdição
ID de modelo na PoYoideogram-v4.6ideogram-v4.6-edit
Endpoint de submissãoPOST https://api.poyo.ai/api/generate/submitO mesmo
ResultadoConsulte GET /api/generate/status/{task_id} ou use callback_urlIgual
Entradaspromptprompt + exatamente uma imagem em image_urls, mask_url e reference_image_urls opcionais
Imagens por pedido1 a 8 (n)1 a 8 (n)
Níveis de qualidadevery_low, low, medium (predefinição), highOs mesmos
Lançamento da Ideogram19 de novembro de 202619 de novembro de 2026
DocumentaçãoReferência da Ideogram V4.6 APIReferê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

CampoRegra na PoYo
promptObrigató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.
sizeauto (predefinição), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16 ou um WIDTHxHEIGHT personalizado
Tamanho personalizadox minúsculo, ambos os lados de 256 a 4096 píxeis e múltiplos de 32, proporção entre 1:6 e 6:1
qualityvery_low, low, medium (predefinição), high; very_low só até 4,194,304 píxeis
nInteiro de 1 a 8
backgroundtransparent ou opaque; apenas text-to-image e edições normais
seedInteiro 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.

QualidadeText-to-image 2KText-to-image 4KEdição 2KEdição 4K
very_low1.6 créditos ($0.008)não disponível1.6 créditos ($0.008)não disponível
low6 créditos ($0.03)12 créditos ($0.06)6 créditos ($0.03)12 créditos ($0.06)
medium12 créditos ($0.06)24 créditos ($0.12)12 créditos ($0.06)40 créditos ($0.20)
high20 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."

TarefaPedidoSaídaCobrado
M4WA9OIQXVV80DHGideogram-v4.6, quality: high, size: 2304x3072, n: 1Um PNG de 2304×3072, cerca de 10.8 MB40 créditos ($0.20)
BS7M64COKT80JSLXMesmo prompt, quality: very_low, size: 3:4PNG de 768×10241.6 créditos ($0.008)
672JRU198S22NS8Dideogram-v4.6-edit sobre o primeiro cartaz, edit_precision: high, context_window: none, size: auto, quality: highPNG de 2304×3072120 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

PedidoID de modelo e definições
Rascunhos e exploração de layoutideogram-v4.6, very_low ou low, um tamanho predefinido, n até 8
Cartazes finais e gráficos para redes sociais até 2048×2048 em áreaideogram-v4.6, high, tamanho personalizado como 1728x2304
Impressão e arte de grande formatoideogram-v4.6, de low a high, tamanho personalizado acima de 4,194,304 píxeis
Alterar um detalhe e manter o restoideogram-v4.6-edit, edit_precision: high
Repintar uma região de uma imagem grandeideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto
Mudar o estilo com uma referência, novo tamanho de saídaideogram-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.

Share: