how-tos

Ideogram 4.6 API: 10 prompts em corpos de requisição para pôsteres, rótulos e edições

Poyo.ai Team
10 min read
Share:

Prompts da Ideogram 4.6 API com corpos de requisição

Este é um conjunto de prompts para a Ideogram 4.6 API, escritos como corpos de requisição completos que você pode colar no código: sete para text-to-image com ideogram-v4.6 e três para edição com ideogram-v4.6-edit. Cada um informa a faixa de tamanho e o preço, para você saber quanto uma execução custa antes de enviá-la. Todos os corpos seguem o schema da PoYo para o Ideogram 4.6 e vão para POST https://api.poyo.ai/api/generate/submit.

O prompt 1 é a requisição exata do nosso teste do dia do lançamento, em 20 de novembro de 2026. Os outros são modelos que não executamos; trate-os como pontos de partida e confira cada saída.

Como escrever um prompt para a Ideogram 4.6 API

O schema permite até 10,000 caracteres, então há espaço para ser específico. Um prompt que funciona bem para tipografia costuma ter cinco partes:

ParteExemplo
Formato"Screen-printed concert poster", "flat vector sticker", "product label"
Texto exato, entre aspas, uma string por linha"NORTHBOUND JAZZ FESTIVAL"
Hierarquia e posição de cada linha"big bold headline at the top", "a smaller line below the art"
Conteúdo visual e paleta"upright bass and saxophone over a river at dusk, teal, burnt orange and cream"
Acabamento"fine paper grain, crisp letterforms, generous margins"

A expansão do prompt está sempre ativa, então o modelo pode adicionar detalhes. No nosso pôster de teste, ele adicionou um pequeno "EST. 1987" e um endereço web nos cantos. A orientação da própria Ideogram é "conferir a ortografia e o posicionamento no resultado final".

Escolha as configurações pela etapa, não pelo hábito: very_low (1.6 créditos, $0.008) para rascunhos de layout, medium (12 créditos, $0.06) como padrão, high para as versões finais. Fique em 4,194,304 pixels ou menos, a não ser que precise de tamanho de impressão; acima disso, todas as qualidades custam o dobro.

Prompts de text-to-image

1. Pôster 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
  }
}

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

2. Rascunhos de layout em uma requisição

{
  "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
  }
}

Faixa: 2K very_low, 8 × 1.6 = 12.8 créditos ($0.064). Escolha o layout de que gostar e depois rode-o de novo 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"
  }
}

Faixa: 2K medium (3,145,728 pixels), 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
  }
}

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

5. Card 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
  }
}

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

6. Thumbnail 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"
  }
}

Faixa: 2K high (3,686,400 pixels), 20 créditos ($0.10). O maior tamanho 16:9 exato acima dele, 4096x2304, custaria 40 créditos.

7. Cena de fachada 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"
  }
}

Faixa: 2K medium, 12 créditos ($0.06). O preset 16:9 retorna 1024×576; use um tamanho personalizado como 2048x1152 para ter mais detalhe na mesma faixa 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 revisar o texto em etapas separadas, então dê a cada edição uma única tarefa e diga o que deve permanecer igual.

8. Alterar uma linha de texto e manter todo 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
  }
}

Faixa: acompanha o tamanho da origem. Medido: no nosso pôster de 2304×3072 (tarefa 672JRU198S22NS8D), a saída continuou com 2304×3072, todos os pixels alterados ficaram dentro de uma única caixa em volta da linha da data, cerca de 1.1% da imagem, e a cobrança foi de 120 créditos ($0.60). Em uma origem de 4,194,304 pixels ou menos, seriam 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"
  }
}

Faixa: edição medium, 12 créditos ($0.06) para uma origem de até 4,194,304 pixels, 40 créditos acima disso. A Ideogram informa 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
  }
}

Faixa: edição regular em low, 2 × 6 = 12 créditos ($0.06) para saídas de até 4,194,304 pixels. Edições regulares regeneram a imagem, então permitem background e um size personalizado; passe para edit_precision: high quando o resto precisar ficar idêntico pixel a pixel.

Transforme um prompt em template

A maioria dos apps não envia um prompt fixo; eles preenchem um template com o nome do evento, o produto ou a data de um usuário. Mantenha as strings entre aspas como variáveis separadas, para poder validá-las antes de a requisição sair e para que uma edição posterior (prompt 8) possa mirar uma delas pela redação exata. Algumas regras mantêm os templates baratos e previsíveis:

  • Escape as aspas no texto do usuário. O prompt é uma string JSON, então um " solto quebra o corpo. Monte o corpo com uma biblioteca JSON, não com concatenação de strings.
  • Mantenha o texto curto. Frases longas em uma imagem pequena são mais difíceis de ler e de conferir. Leve as letras miúdas 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 (pôster, card, thumbnail) e compare-o com a linha de 4,194,304 pixels para que o preço que você mostra aos usuários bata com a cobrança.
  • Registre o ID da tarefa, as configurações e credits_amount. Quando um resultado precisar de correção, você pode rodar de novo o mesmo corpo ou enviar a saída para uma edição sem adivinhar o que a produziu.
  • Rascunhe com n, finalize com uma. Um lote de rascunhos very_low custa menos que uma única imagem high em 2K, e só o layout escolhido segue para a renderização final.

Checklist antes de escalar um prompt

VerificaçãoPor quê
Toda string da 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 pixels ou menosTamanhos maiores o rejeitam
edit_precision: high e máscaras usam size: autoOutros tamanhos são rejeitados
As saídas são baixadas em até 3 diasOs arquivos gerados expiram

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

Perguntas frequentes

Qual pode ser o tamanho de um prompt da Ideogram 4.6 API? De 1 a 10,000 caracteres, com pelo menos um caractere que não seja espaço em branco.

Como obtenho texto exato em uma imagem da Ideogram 4.6 API? Coloque cada linha entre aspas no prompt e descreva onde ela fica. Confira a saída; a expansão do prompt pode adicionar pequenos detalhes extras.

Posso obter várias variações de um mesmo prompt da Ideogram 4.6 API? Sim, defina n de 1 a 8. Cada imagem é cobrada pelo preço da faixa.

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

Qual qualidade devo usar para rascunhos na Ideogram 4.6 API? very_low, a 1.6 créditos ($0.008) por imagem, em tamanhos de até 4,194,304 pixels. Nosso rascunho de teste renderizou o texto do pôster corretamente em 768×1024.

Share: