Skip to main content

Ideogram Character's masked edit from Ideogram repaints only the black area of your mask with the person from one reference portrait, keeping the rest of the picture and its proportions.

Filtering differs by endpoint: Text to image — Uncensored, Image editing — Softened.

From $0.08/image

Workbench

Input

Image editing
122/5000
Describe only what fills the black area: the person, expression, clothing and light, up to 5,000 characters. at least 1 characters · at most 5000 characters
1/1

Drop files or media links, paste, or browse · 1 file · Max 10 MB · JPG · PNG · WEBP

  • 1
1 / 1 files
The picture to edit: JPEG, PNG or WebP up to 10 MB. The result keeps its proportions.
Reference images1/1
  • 1
1 / 1 files
Exactly one portrait of the person to place in the masked area, face clearly visible, up to 10 MB. at least 1 items · at most 1 items
1/1

Drop files or media links, paste, or browse · 1 file · Max 10 MB · JPG · PNG · WEBP

  • 1
1 / 1 files
Black marks the area to repaint, white is kept. Use the same proportions as image_url; you can draw it on the page.
Qualityaffects price
TurboBalancedQuality
turbo, balanced (default) or quality. Higher tiers take longer and cost more per image.
Style
AutoRealisticFiction
auto (default), realistic or fiction. Changes the look, not the price.
Prompt expansion
MagicPrompt, on by default, rewrites short prompts before rendering. Turn it off for exact long prompts.
Seed
Optional integer for repeatable comparisons; it does not guarantee an identical image. no lower than 0 · no higher than 2147483647
Safety checkerOff

SpicyAPI does not run a safety checker on this model. Your prompt and media go to the model as written, and the model itself decides what comes back.

Checking your account before enabling submission and pricing.

Output

Ready for a new run
jazz-stage-inpaintExample result

Missing the model you need?

One reference photo, the same face in every new frame

Ideogram Character API at a glance

Upload one clear portrait, then place that person on a night balcony, at a dressing-room mirror or into the masked part of a stage shot.

Whole setup
1 photo
A single clear portrait replaces training runs and multi-angle reference sets.
Turbo to Quality
3 tiers
Pick speed or detail per request; each tier has its own per-image price.
Images per call
1–4
Ask for several takes of one scene and keep the strongest likeness.
Repaint one area
Masked
Black in the mask is redrawn with your character; everything white is kept.

Results

What you can make with Ideogram Character

  • The reference woman with a dark bob leans on a hotel balcony railing at night in a black satin slip dress, city lights behind her.

    Generation from one portrait

    Night balcony, same bob and fringe

    From a single studio headshot, the Turbo run placed the woman on a hotel balcony in a black satin slip dress with the city lights behind her. The fringe, chin-length bob and the small mark above her lip came through. Treat it as one result of one prompt; generate two to four takes and keep the closest match.

    Generated from one headshot in Turbo, 992 × 992.

  • A jazz-club singer in a gold sequined gown whose head has been repainted as the woman with the dark bob, eyes closed at the microphone.

    Masked repaint

    A new singer on an existing stage

    We masked only the singer's head in a jazz-club still and asked for the woman with the dark bob. The gold sequined gown, microphone, band and red curtain stayed untouched while the face and hair changed to the reference. Black marks the area to redraw; keep the mask a little larger than the head so the hairline blends.

    Masked edit: only the singer's head was redrawn; gown, band and curtain are original.

Content test

Is Ideogram Character uncensored? What we tested

Content levels tested on Ideogram Character, by mode
LevelText to imageImage editing
Mild
RendersTested Nov 13, 2026
RendersTested Nov 13, 2026
Moderate
RendersTested Nov 13, 2026
Not tested yet
Strong
RendersTested Nov 13, 2026
SoftenedTested Nov 13, 2026
Very strong
SoftenedTested Nov 13, 2026
Not tested yet
Maximum
SoftenedTested Nov 13, 2026
Not tested yet
How we test

How each mode behaves

All modes
Only one reference portrait is read per request; a second image in reference_image_urls is rejected.
All modes
Likeness weakens with steep profile angles, heavy occlusion or low-resolution reference photos.
Text to image
Results come back as a 992 × 992 square; there is no aspect-ratio setting on this endpoint.

Use cases

What to build with the Ideogram Character API

  • Recurring characters for stories

    Keep a narrator, mascot or comic lead recognisable from panel to panel without commissioning a fresh illustration each time.

  • Campaign variants of one talent

    Show the same model in an evening look, a studio portrait and a street scene for a lookbook draft before booking a shoot.

  • Casting and costume tests

    Drop a lead actor's headshot into period wardrobe or a lit set to check a styling idea before anyone builds it.

  • Recasting a finished layout

    Mask the placeholder face in a poster, album sleeve or ad comp and repaint it with the approved talent while the design stays intact.

Prompts

Ideogram Character prompt examples you can copy

  • Text to image

    The same face on a night balcony

    The woman leans on a hotel balcony railing at night in a black satin slip dress, one thin strap slipping off her shoulder, city lights blurred behind her, the wind lifting her bob as she looks back over her shoulder with a half smile. Cinematic film still, 35mm.

    Why it works. The prompt never describes her face; it spends every word on place, wardrobe, wind and pose, and lets the portrait supply the likeness.

    Try this prompt
  • Text to image

    Lipstick at a dressing-room mirror

    The woman sits at a vintage dressing-room vanity ringed with warm bulbs, wearing a loose ivory silk robe, putting on red lipstick and meeting her own eyes in the mirror. Photorealistic, soft film grain.

    Why it works. A mirror shot doubles the face, so it is a quick way to check how consistent the likeness is within one frame.

    Try this prompt
  • Image editing

    Repainting the singer's head

    the woman with the dark bob and straight fringe, eyes closed as she sings into the microphone, red stage light on her face

    Why it works. The prompt only describes what belongs inside the mask; the gown, microphone and stage come from the source picture.

    Try this prompt

Pricing

Ideogram Character API pricing

One image starts at $0.08 at turbo and $0.16 at quality.

Get started

How to use the Ideogram Character API in three steps

  1. Step 1

    Choose the portrait

    Use a sharp, evenly lit photo with the face fully visible: no sunglasses, hands or hair across it. The model reads face shape and hairstyle from this one image, so a distinctive cut or a small mark helps the likeness survive a new setting.

  2. Step 2

    Write the new scene

    Refer to the person plainly (the woman, the man, she) and spend the prompt on what changes: place, outfit, pose, light and camera. Leave MagicPrompt on for short ideas; switch it off when every word of a long prompt matters.

  3. Step 3

    Pick tier and count

    Start in Turbo with two to four images to see how the likeness holds up, then rerun the winning prompt in Balanced or Quality. Every returned image is billed at the tier you chose.

Parameter reference and code samples are in the API and Readme tabs at the top of this page.

FAQ

Ideogram Character API FAQ

About Ideogram Character

Ideogram Character is the quick way to keep one person on screen across a whole set of images: no training step, one portrait, and a choice between building a new scene or repainting just the area you mask. Start with a few Turbo takes to check the likeness, then spend Balanced or Quality on the frame that works. Upload only portraits you have permission to use.

Related models and next tasks