
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.6 | Ideogram 4.5 |
|---|---|---|
| Exact color: recolor an object to a brand hex code | 83% | 46% |
| Product detail: repair a small defect in a product photo | 86% | 61% |
| Product shots: stage, restyle and relabel products | 88% | 66% |
| Character consistency: keep a person recognizable in a new scene | 85% | 69% |
| Masked edits: change only the painted area | 90% | 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-image | Edit | |
|---|---|---|
| PoYo model ID | ideogram-v4.6 | ideogram-v4.6-edit |
| Submit endpoint | POST https://api.poyo.ai/api/generate/submit | Same |
| Result | Poll GET /api/generate/status/{task_id} or use callback_url | Same |
| Inputs | prompt | prompt + exactly one image in image_urls, optional mask_url and reference_image_urls |
| Images per request | 1 to 8 (n) | 1 to 8 (n) |
| Quality levels | very_low, low, medium (default), high | Same |
| Ideogram release | November 19, 2026 | November 19, 2026 |
| Docs | Ideogram V4.6 API reference | Ideogram 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
| Field | Rule on PoYo |
|---|---|
prompt | Required, 1 to 10,000 characters, must contain non-whitespace text. Put exact on-image text in quotes. |
size | auto (default), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16, or a custom WIDTHxHEIGHT |
| Custom size | Lowercase x, both sides 256 to 4096 pixels and multiples of 32, aspect ratio within 1:6 and 6:1 |
quality | very_low, low, medium (default), high; very_low only up to 4,194,304 pixels |
n | Integer 1 to 8 |
background | transparent or opaque; text-to-image and regular edits only |
seed | Integer 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.
| Quality | Text-to-image 2K | Text-to-image 4K | Edit 2K | Edit 4K |
|---|---|---|---|---|
very_low | 1.6 credits ($0.008) | not available | 1.6 credits ($0.008) | not available |
low | 6 credits ($0.03) | 12 credits ($0.06) | 6 credits ($0.03) | 12 credits ($0.06) |
medium | 12 credits ($0.06) | 24 credits ($0.12) | 12 credits ($0.06) | 40 credits ($0.20) |
high | 20 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."
| Task | Request | Output | Charged |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | One 2304×3072 PNG, about 10.8 MB | 40 credits ($0.20) |
BS7M64COKT80JSLX | Same prompt, quality: very_low, size: 3:4 | 768×1024 PNG | 1.6 credits ($0.008) |
672JRU198S22NS8D | ideogram-v4.6-edit on the first poster, edit_precision: high, context_window: none, size: auto, quality: high | 2304×3072 PNG | 120 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
| Request | Model ID and settings |
|---|---|
| Drafts and layout exploration | ideogram-v4.6, very_low or low, a preset size, n up to 8 |
| Final posters and social graphics up to 2048×2048 in area | ideogram-v4.6, high, custom size such as 1728x2304 |
| Print and large-format art | ideogram-v4.6, low to high, custom size above 4,194,304 pixels |
| Change one detail and keep the rest | ideogram-v4.6-edit, edit_precision: high |
| Repaint one region of a large image | ideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto |
| Restyle with a reference, new output size | ideogram-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.