Skip to content

Ideogram

Ideogram 3.0 Inpaint

Repaint the part of a source image marked in black on a mask. The prompt describes what belongs in that area.

API model IDideogram/ideogram-3-inpaint
The black area of the mask selects the lime visor. The edit adds blue and violet reflections across its surface.
An iridescent visorThe black area of the mask selects the lime visor. The edit adds blue and violet reflections across its surface.

Best for

Technical details

Read the model documentation
API model ID
ideogram/ideogram-3-inpaint
Provider
Ideogram
Modality
Image
Input
Text prompt · Images · Edit mask
Output
Image
Endpoint
POST /v2/jobs
Workflow
Image edit

Request parameters

  • promptstring · Required

    The prompt describing the repainted result, 1 to 10000 characters.

    1–10000 characters

  • imagestring · Required

    The source image to repaint;

    • the output matches its size, snapped to the nearest supported resolution.
    • A public https URL that answers without a redirect;
    • JPEG, PNG or WEBP, up to 25 MB.
  • maskstring · Required

    A black-and-white mask the same size as `image`; black marks the region to repaint. A public https URL that answers without a redirect; JPEG, PNG or WEBP, up to 25 MB.

  • magic_promptstring

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

    • auto
    • on
    • off
  • rendering_speedstring

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

    • turbo
    • default
    • quality

Additional parameters

  • 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