Ideogram 4.5 API

Ideogram 4.5: best-in-class text rendering, posters, logos and photoreal images, plus natural-language edits and Precise Edit that changes only what you ask. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare image models Use cases

Image Generation

Img2Img

Editing

Credit Cost

2 credits

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/ideogram-4-5/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/ideogram-4-5.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	What to create, or the edit to make when image_urls is supplied. Put any text you want rendered in quotes.	-
`image_urls`	array	Optional, up to 5. Omit for text-to-image. With images the prompt is an edit or composition instruction. With precise: true the first image is edited and the rest guide the edit (up to 4). items: url min items: 1 \| max items: 5	-
`precise`	boolean	Edits only: keep everything the prompt does not mention exactly as it is (framing, layout, other text). Uses Ideogram 4.5 Precise Edit.	`false`
`mask_url`	string	Optional black-and-white mask for edits, matching the first image's size. BLACK pixels are edited, WHITE pixels are preserved (Ideogram's convention).	-
`quality`	enum	very_low (0.5 credits, edits only; text-to-image runs it as low), low (1 credit), medium (2 credits), high (6 credits). Per image. `very_lowlowmediumhigh`	`medium`
`resolution`	enum	Text-to-image output size. "auto" lets Ideogram pick the aspect ratio from the prompt. `auto2048x20481440x28802880x14401664x2496`+32 more	`auto`
`edit_size`	enum	Edit output size (non-precise edits without a mask). "source" keeps the first image's proportions. `source1024x10241280x896896x12801344x768`+3 more	`source`
`num_images`	integer	Images to generate (1-4). Billed per image. min: 1 \| max: 4	`1`
`seed`	integer	Optional seed for reproducible results.	-

Example Outputs

Real outputs generated by this model

View Details

Photoreal shop sign above a hardware store reading "BAKER & SONS HARDWARE EST. 1952", small town main street

2 credits

23.3s

View Details

Children's birthday banner "HAPPY 7TH BIRTHDAY, MILO!" with balloons and confetti, playful rounded font

2 credits

16.7s

View Details

Album cover for synthwave artist "NIGHT DRIVE" titled "Chrome Horizons", sunset grid and palm trees

2 credits

16.7s

View Details

Chalkboard sign outside a cafe reading "Today: Pumpkin Spice Latte" with a hand-drawn leaf

2 credits

16.6s

View Details

Vintage National Park poster "YOSEMITE" with Half Dome at sunrise, WPA style, limited color palette

2 credits

17.4s

View Details

Infographic poster "5 Steps to Better Sleep" with numbered icons and short captions, calm blue palette

2 credits

24.2s

View Details

Sports team logo for "Harbor City Hawks", fierce hawk head, varsity lettering, navy and orange

2 credits

17.0s

View Details

Japanese ramen shop noren curtain with the word "RAMEN" in bold brush lettering, steam and lanterns

2 credits

17.1s

View Details

Tech conference badge style graphic "DEVSUMMIT 2027 SPEAKER", isometric shapes, dark mode palette

2 credits

16.7s

View Details

Wedding invitation card "Ava & Leo, June 14, 2027, Napa Valley" in calligraphy with watercolor vines

2 credits

16.5s

View Details

Bakery storefront window with gold leaf lettering "MAISON BRUN BOULANGERIE", croissants on display, morning light

2 credits

19.4s

View Details

Street sign at a crossroads with arrows pointing to "PARIS 342 KM", "ROME 1105 KM", "OSLO 1840 KM", desert road

2 credits

20.0s

View Details

Botanical illustration poster titled "FERNS OF THE PACIFIC NORTHWEST" with labeled species in small caps

2 credits

26.0s

View Details

YouTube thumbnail with huge bold text "I TRIED IT FOR 30 DAYS", surprised man pointing, bright yellow background

2 credits

16.9s

View Details

Packaging design for organic honey jar label "WILDFLOWER HONEY 12 OZ", bees and flowers line illustration

2 credits

20.7s

View Details

Event flyer for "JAZZ ON THE ROOF" Friday 8 PM, saxophone silhouette, skyline at dusk, art deco typography

2 credits

19.4s

View Details

Book cover for a fantasy novel "The Salt Crown" by "Mara Ellison", ornate gold crown on deep navy, foil lettering

2 credits

16.3s

View Details

Neon sign on a brick wall reading "OPEN LATE" in pink and blue tubes, rainy night reflections

2 credits

16.3s

Ideogram 4.5 example: Instagram quote card that says "Done is better than perfect." in elegant serif, soft beige paper texture, small sprig...

View Details

Instagram quote card that says "Done is better than perfect." in elegant serif, soft beige paper texture, small sprig of olive

2 credits

16.2s

View Details

Vintage diner menu board with prices: "BURGER $6", "FRIES $3", "SHAKE $4", hand-lettered chalk style

2 credits

19.5s

Ideogram 4.5 example: Craft beer can label, hoppy IPA called "HAZY DAYS", sunny pastel illustration of rolling hills, text wraps around the...

View Details

Craft beer can label, hoppy IPA called "HAZY DAYS", sunny pastel illustration of rolling hills, text wraps around the can design

2 credits

17.3s

Ideogram 4.5 example: Movie poster for a sci-fi thriller titled "THE LAST SIGNAL", astronaut silhouette against a red planet, credits block...

View Details

Movie poster for a sci-fi thriller titled "THE LAST SIGNAL", astronaut silhouette against a red planet, credits block at the bottom

2 credits

24.4s

View Details

Retro travel poster for Lisbon, bold headline "LISBOA", yellow tram climbing a hill at sunset, screen-print texture

2 credits

20.7s

View Details

Minimalist coffee shop logo, a steaming cup inside a circle, wordmark "SLOW POUR" in a clean geometric sans serif, cream background

2 credits

14.2s

View Details

Retro travel poster for Lisbon with the headline "LISBOA", yellow tram on a hill at sunset, screen-print style

1 credit

17.9s

View Details

Make the background deep teal

0.5 credits

6.6s

View Details

Change the word HELLO to SALUT

0.5 credits

6.6s

Code Examples

Poster with readable text — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/ideogram-4-5/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Retro travel poster for Lisbon, bold headline \"LISBOA\", tram on a hill at sunset, flat screen-print style",
    "resolution": "2560x1440"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 2,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-03T08:26:59Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 2,
  "expiresAt": "2026-10-03T08:26:59Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits

Ideogram 4.5 API

Get API Key

See Usage

Buy Credits

API Endpoint

Test This Model

LLM.txt

OpenAPI Spec

Parameters

See also

Example Outputs

Code Examples

Response Format

Submit Response (202 Accepted)

Completed Response