guides

Ideogram 4.6 API: What Is Ideogram 4.6, Pricing, Limits and 4K Edits

Poyo.ai Team
9 min read
Share:

Ideogram 4.6 API on PoYo

The Ideogram 4.6 API gives you Ideogram's newest image model through one REST endpoint on PoYo: ideogram-v4.6 for text-to-image and ideogram-v4.6-edit for editing one source image with an optional mask and reference images. Outputs go up to 4096 pixels per side, prices run from 1.6 credits ($0.008) per image, and every request uses the same API key as the rest of PoYo. This page covers what Ideogram 4.6 is, the exact limits, the price tiers, and what we measured on launch day.

What is Ideogram 4.6?

Ideogram 4.6 is an image generation and editing model from Ideogram, released on November 19, 2026. Ideogram calls it "our most precise editing model yet" and says it "generates images in native 4K", with "no upscaling". On its model page, Ideogram also says the model "leaves far less pixel drift outside your edits and holds color more accurately".

Ideogram backs that with task scores at high quality, comparing 4.6 with 4.5:

Task (Ideogram's description)Ideogram 4.6Ideogram 4.5
Exact color: recolor an object to a brand hex code83%46%
Product detail: repair a small defect in a product photo86%61%
Product shots: stage, restyle and relabel products88%66%
Character consistency: keep a person recognizable in a new scene85%69%
Masked edits: change only the painted area90%82%

These are Ideogram's numbers, not PoYo measurements. For an API integration, they point to three kinds of request worth sending here:

  • Posters, labels and social graphics with exact words: put the text in quotes in the prompt.
  • Edits that must leave everything else alone: a new date on a flyer, a recolored product, one changed detail.
  • Large prints: custom sizes up to 4096 pixels per side without a separate upscaling step.

Ideogram 4.6 API at a glance

Text-to-imageEdit
PoYo model IDideogram-v4.6ideogram-v4.6-edit
Submit endpointPOST https://api.poyo.ai/api/generate/submitSame
ResultPoll GET /api/generate/status/{task_id} or use callback_urlSame
Inputspromptprompt + exactly one image in image_urls, optional mask_url and reference_image_urls
Images per request1 to 8 (n)1 to 8 (n)
Quality levelsvery_low, low, medium (default), highSame
Ideogram releaseNovember 19, 2026November 19, 2026
DocsIdeogram V4.6 API referenceIdeogram V4.6 Edit reference

The two IDs share auth, polling and billing, so an app can generate with one and refine with the other without a second integration.

Limits and request fields

FieldRule on PoYo
promptRequired, 1 to 10,000 characters, must contain non-whitespace text. Put exact on-image text in quotes.
sizeauto (default), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16, or a custom WIDTHxHEIGHT
Custom sizeLowercase x, both sides 256 to 4096 pixels and multiples of 32, aspect ratio within 1:6 and 6:1
qualityvery_low, low, medium (default), high; very_low only up to 4,194,304 pixels
nInteger 1 to 8
backgroundtransparent or opaque; text-to-image and regular edits only
seedInteger 0 to 2,147,483,647
image_urls (edit)Exactly one source image, public HTTP(S) URL or base64 data URI, always an array
mask_url (edit)Same dimensions as the source; black is edited, white is kept; needs size: auto
reference_image_urls (edit)0 to 4 images, or at most 3 with a mask
edit_precision (edit)regular (default) or high; high needs size: auto and rejects background
context_window (edit)none (default) or auto; auto needs mask_url and edit_precision: high

Any other field inside input is rejected with an unsupported fields error. Generated files stay available for 3 days, so copy them to your own storage.

Ideogram 4.6 API pricing

PoYo bills per output image, by quality and size tier. "2K" means an output of up to 4,194,304 pixels (2048×2048 in area); anything larger is "4K". 1 credit = $0.005.

QualityText-to-image 2KText-to-image 4KEdit 2KEdit 4K
very_low1.6 credits ($0.008)not available1.6 credits ($0.008)not available
low6 credits ($0.03)12 credits ($0.06)6 credits ($0.03)12 credits ($0.06)
medium12 credits ($0.06)24 credits ($0.12)12 credits ($0.06)40 credits ($0.20)
high20 credits ($0.10)40 credits ($0.20)44 credits ($0.22)120 credits ($0.60)

size: auto and the six presets are always 2K for text-to-image. For edits with size: auto, the output keeps the source geometry, so a large source lands in the 4K tier. These prices match the per-image table on Ideogram's model page; the pricing breakdown works through real request shapes.

What we measured on launch day

The PoYo team ran these on the PoYo production API on November 20, 2026. The prompt was a screen-printed "NORTHBOUND JAZZ FESTIVAL" poster with the lines "JUNE 12-14 · RIVERSIDE PARK" and "Three nights. Twenty-one bands. Free entry before 6 PM."

TaskRequestOutputCharged
M4WA9OIQXVV80DHGideogram-v4.6, quality: high, size: 2304x3072, n: 1One 2304×3072 PNG, about 10.8 MB40 credits ($0.20)
BS7M64COKT80JSLXSame prompt, quality: very_low, size: 3:4768×1024 PNG1.6 credits ($0.008)
672JRU198S22NS8Dideogram-v4.6-edit on the first poster, edit_precision: high, context_window: none, size: auto, quality: high2304×3072 PNG120 credits ($0.60)

All text in the first two posters came out as written, including the small italic line; the draft had a different composition. The edit prompt was: Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. A pixel diff against the original found every changed pixel inside one box, (471, 2699) to (1826, 2756), about 1.1% of the image; the rest was unchanged. The edit used the 4K high tier because a high-precision edit keeps the source resolution. The text and precise edits guide walks through that request.

Your first Ideogram 4.6 API request

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 is 6,291,456 pixels, so this request is billed at the 4K high rate: 2 × 40 = 80 credits ($0.40). The response carries data.task_id with status not_started. Poll the status endpoint until it is finished and read the images from data.files, or pass a top-level callback_url. Always check code in the body: some validation errors return HTTP 200 with code: 400. The API guide has a bounded Python polling loop and a body for every input mode.

Where Ideogram 4.6 is available

Ideogram lists 4.6 in its own app and API, with two endpoints: Generate and Precise Edit. On PoYo you call it with the key you use for every other model, the same task and callback flow, and a Playground on the model page that shows the price before each run. On PoYo, reference images go through ideogram-v4.6-edit; the text-to-image ID takes only a prompt plus the size, quality, n, background and seed controls.

Which requests to route where

RequestModel ID and settings
Drafts and layout explorationideogram-v4.6, very_low or low, a preset size, n up to 8
Final posters and social graphics up to 2048×2048 in areaideogram-v4.6, high, custom size such as 1728x2304
Print and large-format artideogram-v4.6, low to high, custom size above 4,194,304 pixels
Change one detail and keep the restideogram-v4.6-edit, edit_precision: high
Repaint one region of a large imageideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto
Restyle with a reference, new output sizeideogram-v4.6-edit, edit_precision: regular, reference_image_urls, custom size

Coming from Ideogram 4.5? The 4.6 vs 4.5 comparison lists the field changes, the new size rules and the price per same request. Weighing other image APIs on PoYo, see the MAI Image 2.7 API overview and the Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5 comparison.

Frequently asked questions

What is the Ideogram 4.6 API model ID? Use ideogram-v4.6 for text-to-image and ideogram-v4.6-edit for editing. ideogram-4-6 is only the PoYo page slug and is not a model ID.

How much does the Ideogram 4.6 API cost? From 1.6 credits ($0.008) per image at very_low 2K. A default medium 2K image is 12 credits ($0.06), high is 20 credits ($0.10) at 2K and 40 credits ($0.20) at 4K. High-quality 4K edits are 120 credits ($0.60).

What is the largest image the Ideogram 4.6 API can return? Custom sizes go up to 4096 pixels per side, in multiples of 32, with an aspect ratio between 1:6 and 6:1. Anything above 4,194,304 pixels is billed at the 4K tier.

Does the Ideogram 4.6 API render text on images? Yes, put the exact words in quotes in the prompt. In our launch-day test, a 2304×3072 poster rendered the headline, the date line and a small italic line as written. Ideogram still advises checking spelling and placement in the final result.

Can the Ideogram 4.6 API return transparent images? Yes. Set background to transparent for text-to-image or regular edits. High-precision edits reject background.

Is the Ideogram 4.6 API compatible with the OpenAI SDK? No. It is an async task API: submit to /api/generate/submit, then poll /api/generate/status/{task_id} or receive a callback.

Share: