how-tos

Ideogram 4.6 API Prompts: 10 Request Bodies for Posters, Labels and Edits

Poyo.ai Team
9 min read
Share:

Ideogram 4.6 API prompts with request bodies

This is a prompt set for the Ideogram 4.6 API, written as complete request bodies you can paste into code: seven for text-to-image with ideogram-v4.6 and three for editing with ideogram-v4.6-edit. Each one lists the size tier and price, so you know what a run costs before you send it. All bodies follow the PoYo schema for Ideogram 4.6 and go to POST https://api.poyo.ai/api/generate/submit.

Prompt 1 is the exact request from our launch-day test on November 20, 2026. The others are templates we have not run; treat them as starting points and check every output.

How to write an Ideogram 4.6 API prompt

The schema gives you up to 10,000 characters, so there is room to be specific. A prompt that works well for typography usually has five parts:

PartExample
Format"Screen-printed concert poster", "flat vector sticker", "product label"
Exact text, in quotes, one string per line"NORTHBOUND JAZZ FESTIVAL"
Hierarchy and position of each line"big bold headline at the top", "a smaller line below the art"
Visual content and palette"upright bass and saxophone over a river at dusk, teal, burnt orange and cream"
Finish"fine paper grain, crisp letterforms, generous margins"

Prompt expansion is always on, so the model may add details. In our test poster it added a small "EST. 1987" and a web address in the corners. Ideogram's own guidance is to "check spelling and placement in the final result".

Choose settings by stage, not by habit: very_low (1.6 credits, $0.008) for layout drafts, medium (12 credits, $0.06) as a default, high for finals. Stay at or under 4,194,304 pixels unless you need print size; above it, every quality costs double.

Text-to-image prompts

1. Event poster at 4K (tested)

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

Tier: 4K high, 40 credits ($0.20). Measured: task M4WA9OIQXVV80DHG returned a 2304×3072 PNG with all three lines rendered as written, including the small italic line. As a draft, the same prompt with "quality": "very_low" and "size": "3:4" returned 768×1024 for 1.6 credits ($0.008), with correct text and a different composition.

2. Layout drafts in one request

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

Tier: 2K very_low, 8 × 1.6 = 12.8 credits ($0.064). Pick the layout you like, then rerun it at high with a larger size.

3. Product label

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

Tier: 2K medium (3,145,728 pixels), 12 credits ($0.06).

4. Transparent sticker with a 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
  }
}

Tier: 2K low, 6 credits ($0.03). transparent returns an image with an alpha channel. Keep the same seed and body to repeat the result.

5. Social quote card at 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
  }
}

Tier: 2K medium, 4 × 12 = 48 credits ($0.24). 1024x1280 is an exact 4:5 size with both sides multiples of 32.

6. Video thumbnail at 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"
  }
}

Tier: 2K high (3,686,400 pixels), 20 credits ($0.10). The largest exact 16:9 size above it, 4096x2304, would cost 40 credits.

7. Storefront scene with a sign

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

Tier: 2K medium, 12 credits ($0.06). The 16:9 preset returns 1024×576; use a custom size such as 2048x1152 for more detail at the same price tier.

Edit prompts

Edits use ideogram-v4.6-edit with exactly one image in image_urls. Ideogram's page suggests revising wording in separate steps, so give each edit one job and say what must stay the same.

8. Change one line of text, keep everything else

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

Tier: follows the source size. Measured: on our 2304×3072 poster (task 672JRU198S22NS8D), the output stayed 2304×3072, every changed pixel was inside one box around the date line, about 1.1% of the image, and the charge was 120 credits ($0.60). On a source of 4,194,304 pixels or less it would be 44 credits ($0.22).

9. Recolor a product to a brand color

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

Tier: medium edit, 12 credits ($0.06) for a source up to 4,194,304 pixels, 40 credits above. Ideogram reports 83% usable results on its "exact color" task at high quality, up from 46% on Ideogram 4.5.

10. Change the material, guided by a reference

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

Tier: regular edit at low, 2 × 6 = 12 credits ($0.06) for outputs up to 4,194,304 pixels. Regular edits regenerate the image, so they allow background and a custom size; switch to edit_precision: high when the rest must stay pixel-exact.

Turn a prompt into a template

Most apps do not send one fixed prompt; they fill a template with a user's event name, product or date. Keep the quoted strings as separate variables so you can validate them before the request goes out, and so a later edit (prompt 8) can target one of them by its exact wording. A few rules keep templates cheap and predictable:

  • Escape quotes in user text. The prompt is a JSON string, so a stray " breaks the body. Build the body with a JSON library rather than string concatenation.
  • Keep text short. Long sentences on a small image are harder to read and harder to check. Move fine print to a second line with its own size description.
  • Fix the size per format. Store one size per output type (poster, card, thumbnail) and check it against the 4,194,304-pixel line so the price you show users matches the bill.
  • Log the task ID, settings and credits_amount. When a result needs a fix, you can rerun the same body or send the output to an edit without guessing what produced it.
  • Draft with n, finish with one. A batch of very_low drafts costs less than a single high 2K image, and only the chosen layout moves on to a final render.

Checklist before you scale a prompt

CheckWhy
Every on-image string is in quotesThe docs' rule for exact text
Custom sizes are multiples of 32, 256 to 4096 per sideOthers are rejected
very_low only at 4,194,304 pixels or lessLarger sizes reject it
edit_precision: high and masks use size: autoOther sizes are rejected
Outputs are downloaded within 3 daysGenerated files expire

The Ideogram 4.6 API guide has a polling loop that runs any of these bodies, and the text and precise edits how-to goes deeper into prompts 8 to 10.

Frequently asked questions

How long can an Ideogram 4.6 API prompt be? 1 to 10,000 characters, with at least one non-whitespace character.

How do I get exact text in an Ideogram 4.6 API image? Quote each line in the prompt and describe where it goes. Check the output; prompt expansion can add small extra details.

Can I get several variations from one Ideogram 4.6 API prompt? Yes, set n from 1 to 8. Each image is billed at the tier price.

How do I repeat an Ideogram 4.6 API result? Send the same body with the same seed, an integer from 0 to 2,147,483,647.

Which quality should I use for Ideogram 4.6 API drafts? very_low at 1.6 credits ($0.008) per image, at sizes up to 4,194,304 pixels. Our test draft rendered the poster text correctly at 768×1024.

Share: