how-tos

Ideogram 4.6 API: 10 prompts e corpos de pedido para cartazes, rótulos e edições

Poyo.ai Team
10 min read
Share:

Prompts para a Ideogram 4.6 API com corpos de pedido

Este é um conjunto de prompts para a Ideogram 4.6 API, escritos como corpos de pedido completos que pode colar no seu código: sete para text-to-image com ideogram-v4.6 e três para edição com ideogram-v4.6-edit. Cada um indica o escalão de tamanho e o preço, para que saiba quanto custa uma execução antes de a enviar. Todos os corpos seguem o esquema da PoYo para o Ideogram 4.6 e são enviados para POST https://api.poyo.ai/api/generate/submit.

O prompt 1 é o pedido exato do nosso teste do dia do lançamento, a 20 de novembro de 2026. Os restantes são modelos que não executámos; trate-os como ponto de partida e verifique cada saída.

Como escrever um prompt para a Ideogram 4.6 API

O esquema dá-lhe até 10,000 carateres, por isso há espaço para ser específico. Um prompt que funciona bem para tipografia tem normalmente cinco partes:

ParteExemplo
Formato«Cartaz de concerto serigrafado», «sticker vetorial plano», «rótulo de produto»
Texto exato, entre aspas, uma string por linha"NORTHBOUND JAZZ FESTIVAL"
Hierarquia e posição de cada linha«título grande a negrito no topo», «uma linha mais pequena por baixo da ilustração»
Conteúdo visual e paleta«contrabaixo e saxofone sobre um rio ao entardecer, azul-petróleo, laranja queimado e creme»
Acabamento«grão de papel fino, letras nítidas, margens generosas»

A expansão do prompt está sempre ativa, por isso o modelo pode acrescentar detalhes. No nosso cartaz de teste, acrescentou um pequeno "EST. 1987" e um endereço web nos cantos. A recomendação da própria Ideogram é «verificar a ortografia e o posicionamento no resultado final».

Escolha as definições pela fase, não por hábito: very_low (1.6 créditos, $0.008) para rascunhos de layout, medium (12 créditos, $0.06) como predefinição e high para as versões finais. Fique nos 4,194,304 píxeis ou abaixo, a menos que precise de tamanho de impressão; acima disso, todas as qualidades custam o dobro.

Prompts de text-to-image

1. Cartaz de evento em 4K (testado)

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
    "size": "2304x3072",
    "quality": "high",
    "n": 1
  }
}

Escalão: 4K high, 40 créditos ($0.20). Medido: a tarefa M4WA9OIQXVV80DHG devolveu um PNG de 2304×3072 com as três linhas renderizadas tal como estavam escritas, incluindo a pequena linha em itálico. Como rascunho, o mesmo prompt com "quality": "very_low" e "size": "3:4" devolveu 768×1024 por 1.6 créditos ($0.008), com o texto correto e uma composição diferente.

2. Rascunhos de layout num único pedido

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Minimal bookstore event flyer with the headline \"AUTHOR NIGHT\" in large serif capitals, the line \"Thursday 7 PM · Upstairs\" below it, and a simple line drawing of an open book. Off-white paper, black and brick red.",
    "size": "3:4",
    "quality": "very_low",
    "n": 8
  }
}

Escalão: 2K very_low, 8 × 1.6 = 12.8 créditos ($0.064). Escolha o layout de que gosta e volte a executá-lo em high com um tamanho maior.

3. Rótulo de produto

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Front label for a small-batch hot sauce bottle, flat design, centered. Top line \"CASA FUEGO\" in a hand-painted script, middle line \"SMOKED HABANERO\" in bold sans-serif capitals, bottom line \"5 FL OZ · 148 ML\" in small type. Red, cream and charcoal, with a small chili illustration.",
    "size": "1536x2048",
    "quality": "medium"
  }
}

Escalão: 2K medium (3,145,728 píxeis), 12 créditos ($0.06).

4. Sticker transparente com seed

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "A die-cut sticker of a cheerful cactus wearing sunglasses, with the words \"STAY SHARP\" on a curved banner underneath. Thick white outline, flat colors.",
    "size": "1:1 HD",
    "quality": "low",
    "background": "transparent",
    "seed": 42
  }
}

Escalão: 2K low, 6 créditos ($0.03). transparent devolve uma imagem com canal alfa. Mantenha o mesmo seed e o mesmo corpo para repetir o resultado.

5. Cartão de citação para redes sociais em 4:5

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Instagram quote card. Large centered quote \"Ship small. Ship often.\" in a modern grotesk typeface, and below it a small line \"— The Release Notes Podcast\". Solid sage green background with a thin cream border.",
    "size": "1024x1280",
    "quality": "medium",
    "n": 4
  }
}

Escalão: 2K medium, 4 × 12 = 48 créditos ($0.24). 1024x1280 é um tamanho 4:5 exato com ambos os lados múltiplos de 32.

6. Miniatura de vídeo em 16:9

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "YouTube thumbnail, bold and high contrast. Left half: the text \"I BUILT A TINY CABIN\" in thick white capitals with a black outline, stacked on three lines. Right half: a small wooden cabin in a snowy forest at blue hour, warm light in the windows.",
    "size": "2560x1440",
    "quality": "high"
  }
}

Escalão: 2K high (3,686,400 píxeis), 20 créditos ($0.10). O tamanho 16:9 exato seguinte acima deste, 4096x2304, custaria 40 créditos.

7. Cena de uma loja com letreiro

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Photograph of a corner bakery at sunrise, wet cobblestones, a hand-painted wooden sign above the door reading \"MORNING CRUMB\", and a chalkboard by the door reading \"Fresh rye today\". Natural light, 35mm look.",
    "size": "16:9",
    "quality": "medium"
  }
}

Escalão: 2K medium, 12 créditos ($0.06). A predefinição 16:9 devolve 1024×576; use um tamanho personalizado como 2048x1152 para obter mais detalhe no mesmo escalão de preço.

Prompts de edição

As edições usam ideogram-v4.6-edit com exatamente uma imagem em image_urls. A página da Ideogram sugere rever o texto em passos separados, por isso dê a cada edição uma única tarefa e indique o que deve ficar igual.

8. Alterar uma linha de texto e manter tudo o resto

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
    "image_urls": [
      "https://example.com/northbound-poster.png"
    ],
    "edit_precision": "high",
    "context_window": "none",
    "size": "auto",
    "quality": "high",
    "n": 1
  }
}

Escalão: segue o tamanho da origem. Medido: no nosso cartaz de 2304×3072 (tarefa 672JRU198S22NS8D), a saída manteve-se em 2304×3072, todos os píxeis alterados ficaram dentro de uma única caixa à volta da linha da data, cerca de 1.1% da imagem, e o custo foi de 120 créditos ($0.60). Numa origem de 4,194,304 píxeis ou menos, custaria 44 créditos ($0.22).

9. Recolorir um produto com a cor da marca

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Recolor the ceramic mug to the exact brand blue #1E6FD9. Keep the mug's shape, handle, shadows, the table and the background exactly the same.",
    "image_urls": [
      "https://example.com/mug.png"
    ],
    "edit_precision": "high",
    "quality": "medium"
  }
}

Escalão: edição medium, 12 créditos ($0.06) para uma origem até 4,194,304 píxeis, 40 créditos acima disso. A Ideogram indica 83% de resultados utilizáveis na sua tarefa de «cor exata» em qualidade alta, contra 46% no Ideogram 4.5.

10. Alterar o material, guiado por uma referência

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Change the toy car's body to brushed copper like the reference image. Keep the scene, lighting and camera angle the same.",
    "image_urls": [
      "https://example.com/toy-car.png"
    ],
    "reference_image_urls": [
      "https://example.com/copper-swatch.png"
    ],
    "quality": "low",
    "n": 2
  }
}

Escalão: edição normal em low, 2 × 6 = 12 créditos ($0.06) para saídas até 4,194,304 píxeis. As edições normais regeneram a imagem, por isso permitem background e um size personalizado; mude para edit_precision: high quando o resto tiver de ficar exato ao píxel.

Transformar um prompt num modelo reutilizável

A maioria das aplicações não envia um prompt fixo; preenche um modelo com o nome do evento, o produto ou a data do utilizador. Mantenha as strings entre aspas como variáveis separadas, para as poder validar antes de o pedido sair e para que uma edição posterior (prompt 8) possa visar uma delas pelo seu texto exato. Algumas regras mantêm os modelos baratos e previsíveis:

  • Escape as aspas no texto do utilizador. O prompt é uma string JSON, por isso um " solto parte o corpo. Construa o corpo com uma biblioteca JSON em vez de concatenar strings.
  • Mantenha o texto curto. Frases longas numa imagem pequena são mais difíceis de ler e de verificar. Passe as letras miudinhas para uma segunda linha com a sua própria descrição de tamanho.
  • Fixe o tamanho por formato. Guarde um tamanho por tipo de saída (cartaz, cartão, miniatura) e compare-o com a linha de 4,194,304 píxeis, para que o preço que mostra aos utilizadores coincida com a fatura.
  • Registe o ID da tarefa, as definições e credits_amount. Quando um resultado precisar de correção, pode voltar a executar o mesmo corpo ou enviar a saída para uma edição sem adivinhar o que a produziu.
  • Faça rascunhos com n e termine com um. Um lote de rascunhos very_low custa menos do que uma única imagem high 2K, e só o layout escolhido passa para a renderização final.

Lista de verificação antes de escalar um prompt

VerificaçãoPorquê
Cada string que aparece na imagem está entre aspasÉ a regra da documentação para texto exato
Os tamanhos personalizados são múltiplos de 32, de 256 a 4096 por ladoOs outros são rejeitados
very_low só com 4,194,304 píxeis ou menosOs tamanhos maiores rejeitam-no
edit_precision: high e as máscaras usam size: autoOs outros tamanhos são rejeitados
As saídas são descarregadas no prazo de 3 diasOs ficheiros gerados expiram

O guia da Ideogram 4.6 API tem um ciclo de polling que executa qualquer um destes corpos, e o guia de texto e edições precisas aprofunda os prompts 8 a 10.

Perguntas frequentes

Qual pode ser o comprimento de um prompt da Ideogram 4.6 API? De 1 a 10,000 carateres, com pelo menos um caráter que não seja um espaço.

Como obtenho texto exato numa imagem da Ideogram 4.6 API? Coloque cada linha entre aspas no prompt e descreva onde fica. Verifique a saída; a expansão do prompt pode acrescentar pequenos detalhes extra.

Posso obter várias variações a partir de um prompt da Ideogram 4.6 API? Sim, defina n de 1 a 8. Cada imagem é faturada ao preço do seu escalão.

Como repito um resultado da Ideogram 4.6 API? Envie o mesmo corpo com o mesmo seed, um inteiro de 0 a 2,147,483,647.

Que qualidade devo usar para rascunhos da Ideogram 4.6 API? very_low, a 1.6 créditos ($0.008) por imagem, em tamanhos até 4,194,304 píxeis. O nosso rascunho de teste renderizou corretamente o texto do cartaz em 768×1024.

Share: