Image Generation

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

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.	-

Use saved characters (@Name)

Write @Name in the prompt to use a character, product, outfit, location, prop or style saved in the account's Character Studio, for example "@Mara on a beach at sunset". Its photos are added to image_urls automatically, after any images you send yourself, so your own image numbering is unchanged. List saved names with GET /api/v1/characters and save new ones with POST /api/v1/characters. An @word that names nothing saved stays plain text.

Example Outputs

Real outputs generated by this model

View Details

A cinematic side-profile portrait of an astronaut standing on a rocky alien beach at sunset, salt spray in the air, twin suns glowing on the horizon, helmet visor catching warm orange light, weathered patches on the spacesuit. Anamorphic lens, soft rim light, sharp focus on the visor.

2 credits

17.6s

Ideogram 4.5 example: Photograph of a vintage brick bakery storefront with "BAKER & SONS" hand-painted in gold lettering on a dark green aw...

View Details

Photograph of a vintage brick bakery storefront with "BAKER & SONS" hand-painted in gold lettering on a dark green awning, loaves stacked in the window, a chalkboard sign by the door, warm afternoon light.

2 credits

22.5s

Ideogram 4.5 example: Editorial product shot of a tan leather tote bag on a stone plinth against a warm beige backdrop, the headline "NEW S...

View Details

Editorial product shot of a tan leather tote bag on a stone plinth against a warm beige backdrop, the headline "NEW SEASON" in bold serif across the top, a small line "Autumn Collection" below it, soft studio light.

2 credits

19.9s

Ideogram 4.5 example: Business magazine cover with the cover line "FUTURE WORK" in large bold serif across the top, two smaller lines of su...

View Details

Business magazine cover with the cover line "FUTURE WORK" in large bold serif across the top, two smaller lines of supporting text on the left, a woman in a charcoal suit standing in a glass office on the right two thirds, clean editorial photography.

2 credits

19.4s

Ideogram 4.5 example: Square social media quote card with the words "Make it simple, make it yours." in elegant serif type centered on a so...

View Details

Square social media quote card with the words "Make it simple, make it yours." in elegant serif type centered on a soft peach to cream gradient, a thin line and the small text "@studio" below, minimal premium design.

2 credits

13.0s

Ideogram 4.5 example: Retro 1970s concert poster for "MIDNIGHT FESTIVAL" with the date "OCT 24" below, chunky groovy display lettering in o...

View Details

Retro 1970s concert poster for "MIDNIGHT FESTIVAL" with the date "OCT 24" below, chunky groovy display lettering in orange, pink and cream, a sunburst behind a silhouetted guitarist, layered halftone shapes, slightly worn print texture.

2 credits

20.0s

Ideogram 4.5 example: Literary fiction hardcover book cover. A lone lighthouse on a dark basalt cliff at dusk, fog rolling in from a deep b...

View Details

Literary fiction hardcover book cover. A lone lighthouse on a dark basalt cliff at dusk, fog rolling in from a deep blue sea, one warm light in the lantern room. Title at the top in an elegant high-contrast serif: "The Last Architect". Author line at the bottom in small spaced capitals: "ELENA MARCH". Generous margins, matte paper texture, restrained palette of slate blue, bone white and a single amber accent.

2 credits

23.3s

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-11-12T16:17:11Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 2,
  "expiresAt": "2026-11-12T16:17:11Z"
}

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

Use saved characters (@Name)

See also

Example Outputs

Code Examples

Response Format

Submit Response (202 Accepted)

Completed Response