Ideogram 4.5: best-in-class typography for posters, logos and graphic design.
from$0.027/ image$0.0310% off
Model IDideogram-4.5
Input
Text · Image
Output
Image
Provider
1 providers
Aspect ratio
1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3
Quality
low · medium · high
Images
1 – 4
Last 7 days · not enough recent requests for stats yet.
Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.
| Option | Price (USD) |
|---|---|
| quality: low | $0.027 / image 3 Credits |
| quality: medium | $0.054 / image 6 Credits |
| quality: high | $0.198 / image 20 Credits |
Test output quality, compare provider prices and estimate cost before writing any code.
Enter a prompt to compare provider prices.
Ready-to-use prompts. Load one into the playground and tweak it.
5 prompts
A hyper-detailed miniature diorama of a cozy bookshop built inside a vintage porcelain teacup: tiny bookshelves, a spiral staircase, warm lamplight in the windows, a hanging sign reading "LOST & FOUND BOOKS" and a chalkboard "OPEN · EST. 1921", steam curling like clouds above the roof. Macro photography, tilt-shift, soft morning light.
A tiny bookshop built inside a porcelain teacup, hand-painted signs reading "LOST & FOUND BOOKS" and "OPEN · EST. 1921", steam drifting like clouds, macro tilt-shift, soft morning light.
Minimal logo for a coffee roastery called "North Ember": a stylised flame forming a mountain peak, warm orange and charcoal, clean vector look on white.
Bold concert poster for "Blue Hour Jazz Night", Friday 9 PM, a silhouetted saxophonist, deep blue and gold palette, Art Deco typography.
A sheet of six cute die-cut stickers of houseplants with smiling faces, each with a short label such as "Monstera" and "Snake Plant", white borders.
Endpoints, request fields and runnable examples for this model.
Base URL
https://01router.com/api/v1Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.
Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.
curl https://01router.com/api/v1/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "ideogram-4.5",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"aspect_ratio": "1:1",
"quality": "medium",
"num_images": 1
}
}
JSON
# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.
/api/v1/generationsCreate a generation (charges credits) · API key required
/api/v1/generations/{id}Get a generation; polls the provider while running · API key required
/api/v1/generations/{id}/cancelCancel a running generation (credits refunded) · API key required
/api/v1/quotePrice a request on every provider (no charge, no key needed) · Public · no key
/api/v1/images/generationsOpenAI-compatible image generation (waits for the result) · API key required
/api/v1/models/ideogram-4.5Get one model · Public · no key
Send your API key as a Bearer token. Requests are billed to the key owner's credits.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonSend JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.
| Name | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | "ideogram-4.5" |
| provider | string | No | Pin a provider; omit to auto-route to the cheapest. One of: fal |
| input | object | Yes | Model parameters, see the input fields below. |
| callback_url | string | No | Optional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available. |
Required fields are marked explicitly. Other fields use the listed defaults when omitted.
| Name | Type | Required | Values | Default |
|---|---|---|---|---|
| prompt* | string | Yes | — | — |
| image_urls Optional — switches to image editing | string[] | No | maxItems: 1 | — |
| aspect_ratio | string | No | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 3:2 | 2:3 | 1:1 |
| quality | string | No | low | medium | high | medium |
| num_images | integer | No | min: 1 · max: 4 | 1 |
| seed | integer | No | min: 0 · max: 2147483647 | — |
Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.
{
"id": "gen_example",
"object": "generation",
"model": "ideogram-4.5",
"type": "image",
"provider": "fal",
"status": "processing",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"aspect_ratio": "1:1",
"quality": "medium",
"num_images": 1
},
"outputs": [],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": null
}{
"id": "gen_example",
"object": "generation",
"model": "ideogram-4.5",
"type": "image",
"provider": "fal",
"status": "succeeded",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"aspect_ratio": "1:1",
"quality": "medium",
"num_images": 1
},
"outputs": [
"https://example.com/output.png"
],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-25T08:00:00.000Z",
"completed_at": "2026-10-25T08:01:00.000Z"
}| Name | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Generation ID. Use it to query or cancel this task. |
| object | string | Yes | generation |
| model | string | Yes | ideogram-4.5 |
| type | string | Yes | image |
| provider | string | Yes | Provider |
| status | string | Yes | queued → processing → succeeded / failed. Stop polling at either terminal state. |
| input | object | Yes | Model parameters, see the input fields below. |
| outputs | string[] | Yes | Result URLs. Empty while processing; read after succeeded and save the files promptly. |
| error | string | null | Yes | Failure reason, or null when no failure is reported. |
| credits | number | Yes | Credits charged for this request. |
| price_usd | number | Yes | Request price in USD. |
| created_at | string | Yes | Creation time in ISO 8601 format. |
| completed_at | string | null | Yes | Completion time in ISO 8601 format; null before completion. |
Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.
curl "https://01router.com/api/v1/generations/GENERATION_ID" \
-H "Authorization: Bearer $API_KEY"queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.
Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.
curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
-H "Authorization: Bearer $API_KEY"Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.
curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
"model": "ideogram-4.5",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"aspect_ratio": "1:1",
"quality": "medium",
"num_images": 1
}
}
JSONFor OpenAI SDK integrations, use this endpoint with top-level prompt. It waits for the result and returns data[].url. For asynchronous tasks and the full model parameter set, use /generations.
curl "https://01router.com/api/v1/images/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" --data-binary @- <<'JSON'
{
"model": "ideogram-4.5",
"prompt": "A cinematic shot of a red fox running through snow"
}
JSON{
"created": 1792915200,
"data": [
{
"url": "https://example.com/output.png"
}
]
}This public endpoint returns the model parameters and each provider’s supported constraints and prices.
curl "https://01router.com/api/v1/models/ideogram-4.5"Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.
{
"error": {
"message": "Invalid or missing API key",
"code": "unauthorized"
}
}400Invalid body or parameter value
401Missing or invalid API key
402Not enough credits
404Unknown model or generation
409The task cannot be canceled (already finished, or the provider does not support canceling)
429Too many requests — retry after the given seconds
502Every provider rejected the task (credits refunded)
Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.
Specs and starting prices side by side. Test with the same prompt before you choose.
| Ideogram 4.5 | GPT Image 2.5 Flare | GPT Image 2.5 Sunburst | Nano Banana 2.1 | |
|---|---|---|---|---|
| Vendor | Ideogram | OpenAI | OpenAI | |
| Starting price | $0.027 / image | $0.0053 / image | $0.0053 / image | $0.018 / image |
| Input | Text · Image | Text · Image | Text · Image | Text · Image |
| Provider | 1 providers | 6 providers | 6 providers | 8 providers |
| Aspect ratio | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 | 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 | 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9 |
| Quality | low · medium · high | low · medium · high · xhigh · max | low · medium · high · xhigh · max | — |
| Images | 1 – 4 | 1 – 4 | 1 – 4 | 1 – 4 |
Designs where text must be right: posters, logos, packaging, social graphics and stickers, as well as realistic and stylised images.
low is the fastest and cheapest, medium is the default balance, and high gives the most refined detail. Image size does not change the price.
Set num_images from 1 to 4 to get several variations at once, which is useful for logo exploration.
Providers may expand short prompts automatically. Write the exact text in quotes so it is kept verbatim.
Per generated image by quality level; see the pricing table. Failed generations are refunded.
Other models you can call with the same API key.
OpenAI GPT Image 2.5 Flare: fast everyday generation and editing with precise text rendering.
OpenAI GPT Image 2.5 Sunburst: tighter control for demanding edits and premium creative.
Google Gemini image model: consistent multi-reference editing, 1K–4K output.
ByteDance Seedream 5.0 Pro: photoreal images, multilingual text and up to 10-reference editing.
Gemini 3.1 Flash Image: fast generation and editing with strong text rendering, 1K–4K.
Low-latency Seedream 5.0: same price for 1K–2K, up to 10 reference images.