Skip to content

Ideogram

Ideogram 3.0

Generate a picture from a prompt and steer its palette and visual style. A saved style code or reference images can carry the same look across a series.

API model IDideogram/ideogram-3
Bold lettering and overlapping citrus slices fill a Japanese-style screenprint.
Yuzu in four inksBold lettering and overlapping citrus slices fill a Japanese-style screenprint.

Best for

Technical details

Read the model documentation
API model ID
ideogram/ideogram-3
Provider
Ideogram
Modality
Image
Input
Text prompt · Images
Output
Image
Endpoint
POST /v2/jobs
Workflow
Text to image
Aspect ratios
auto · 1x3 · 3x1 · 1x2 · 2x1 · 9x16 · 16x9 · 10x16 · 16x10 · 2x3 · 3x2 · 3x4 · 4x3 · 4x5 · 5x4 · 1x1

Request parameters

  • promptstring · Required

    The prompt to generate images from, 1 to 10000 characters.

    1–10000 characters

  • resolutionstring

    Choose exact output dimensions from the supported presets. Set resolution or aspect_ratio in a request.

    Square
    • 1024x1024
    Portrait
    • 512x1536
    • 576x1408
    • 576x1472
    • 576x1536
    • 640x1344
    • 640x1408
    • 640x1472
    • 640x1536
    • 704x1152
    • 704x1216
    • 704x1280
    • 704x1344
    • 704x1408
    • 704x1472
    • 736x1312
    • 768x1088
    • 768x1216
    • 768x1280
    • 768x1344
    • 800x1280
    • 832x960
    • 832x1024
    • 832x1088
    • 832x1152
    • 832x1216
    • 832x1248
    • 864x1152
    • 896x960
    • 896x1024
    • 896x1088
    • 896x1120
    • 896x1152
    • 960x1024
    • 960x1088
    Landscape
    • 960x832
    • 960x896
    • 1024x832
    • 1024x896
    • 1024x960
    • 1088x768
    • 1088x832
    • 1088x896
    • 1088x960
    • 1120x896
    • 1152x704
    • 1152x832
    • 1152x864
    • 1152x896
    • 1216x704
    • 1216x768
    • 1216x832
    • 1248x832
    • 1280x704
    • 1280x768
    • 1280x800
    • 1312x736
    • 1344x640
    • 1344x704
    • 1344x768
    • 1408x576
    • 1408x640
    • 1408x704
    • 1472x576
    • 1472x640
    • 1472x704
    • 1536x512
    • 1536x576
    • 1536x640
  • aspect_ratiostring

    The output aspect ratio written width x height, for example `16x9`;

    • auto
    • 1x3
    • 3x1
    • 1x2
    • 2x1
    • 9x16
    • 16x9
    • 10x16
    • 16x10
    • 2x3
    • 3x2
    • 3x4
    • 4x3
    • 4x5
    • 5x4
    • 1x1
    • `auto` lets the model pick one from the prompt and leaving the field out means `1x1`, not `auto`;
    • it cannot be combined with `resolution`.
  • color_palette

    A color palette for the result: either a preset chosen by `name` or your own `members`.

    • ember
    • fresh
    • jungle
    • magic
    • melon
    • mosaic
    • pastel
    • ultramarine
    • Custom palettes accept up to 8 colours in #RGB or #RRGGBB format.
    • Optional colour weights range from 0.05 to 1.
  • magic_promptstring

    Controls magic prompt, the automatic rewriting of the prompt: `auto` (the default), `on` or `off`.

    • auto
    • on
    • off

Additional parameters

  • negative_promptstring

    Description of what to exclude from the images, up to 10000 characters; the prompt takes precedence over it.

    0–10000 characters

  • rendering_speedstring

    The rendering speed: `turbo` is the fastest and cheapest, `quality` the slowest and best; it defaults to `default`.

    • turbo
    • default
    • quality
  • seedinteger

    Random seed, a whole number from 0 to 2147483647; set it for reproducible generation.

    0–2147483647

  • style_codesarray

    Up to 50 style codes, each 8 hexadecimal characters, that represent the style of an image; they cannot be combined with `style_preset`.

    Up to 50 items

  • style_presetstring

    Apply a named artistic style. Use the preset on its own, without style codes or style reference images.

    • 80s_illustration
    • 90s_nostalgia
    • abstract_organic
    • analog_nostalgia
    • art_brut
    • art_deco
    • art_poster
    • aura
    • avant_garde
    • bauhaus
    • blueprint
    • blurry_motion
    • bright_art
    • c4d_cartoon
    • childrens_book
    • collage
    • coloring_book_i
    • coloring_book_ii
    • cubism
    • dark_aura
    • doodle
    • double_exposure
    • dramatic_cinema
    • editorial
    • emotional_minimal
    • ethereal_party
    • expired_film
    • flat_art
    • flat_vector
    • forest_reverie
    • geo_minimalist
    • glass_prism
    • golden_hour
    • graffiti_i
    • graffiti_ii
    • halftone_print
    • high_contrast
    • hippie_era
    • iconic
    • japandi_fusion
    • jazzy
    • long_exposure
    • magazine_editorial
    • minimal_illustration
    • mixed_media
    • monochrome
    • nightlife
    • oil_painting
    • old_cartoons
    • paint_gesture
    • pop_art
    • retro_etching
    • riviera_pop
    • spotlight_80s
    • stylized_red
    • surreal_collage
    • travel_poster
    • vintage_geo
    • vintage_poster
    • watercolor
    • weird
    • woodblock_print
  • style_reference_imagesarray

    Images whose style the result borrows; they cannot be combined with `style_preset`. 1 to 10 public https URLs that answer without a redirect; each JPEG, PNG or WEBP, up to 25 MB.

    1–10 items

  • style_typestring

    The style type to generate with: `auto`, `general`, `realistic`, `design`, `custom`, `fiction` or `stylized`.

    • auto
    • general
    • realistic
    • design
    • custom
    • fiction
    • stylized

Pricing

Billable unit and optionsRate (USD)
Per imagerendering_speed: turbo$0.03
Per imagerendering_speed: default$0.06
Per imagerendering_speed: quality$0.09

Billing notes

  • Leaving out rendering_speed gives default.
  • Every image the generator produces is billed, including an image it withholds after its safety check (a withheld image is not delivered); num_images multiplies the price.

Catalogue rates on 21 Nov 2026. Prices exclude VAT.

View in pricing catalogue