SandBase is live — $1 in free credits on signupStart free ›

Ideogram modelsimage generation api

ideogram-ai/ideogram-v3/character

Ideogram V3 Character is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Input
The prompt to fill the masked part of the image.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format
The rendering speed to use. Allowed values: TURBO, BALANCED, QUALITY.
A set of masks to apply to the character references. Currently only 1 mask is supported, rest will be ignored. (maximum total size 10MB across all character references). The masks should be in JPEG, PNG or WebP format

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

A set of images to use as character references. Currently only 1 image is supported, rest will be ignored. (maximum total size 10MB across all character references). The images should be in JPEG, PNG or WebP format
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Seed for the random number generator
Idle

Example output — click Run to generate your own

API README

Ideogram V3 Character

ideogram-ai/ideogram-v3/character generates imagery around a supplied character reference, preserving recognizable identity while changing scene, pose, styling, or composition. Ideogram V3 Character emphasizes identity consistency so a recurring person or designed character can appear across varied creative situations without being redefined each time. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with ideogram-ai/ideogram-v3/character, it supports character campaigns, storyboards, creator assets, product mascots, and narrative sequences where recognizability must survive substantial visual variation. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Character identity preservation keeps distinctive facial and design traits recognizable.

Scene variation places the same character into new environments, poses, and compositions.

Typography-aware design combines recurring characters with readable campaign or story text.

Style flexibility carries character identity across photographic, illustrated, and graphic treatments.

Pricing

Rendering speedPrice per image
Turbo$0.100
Balanced$0.150
Quality$0.200

When to Use

✅ Good fit❌ Consider alternatives
The model's named workflow matches the source material and intended outputA different input modality or model route is required
A managed asynchronous result is suitable for the production pipelineA synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or formatThe project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structureExact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverableEditable source layers or a native project file are required

Prompt Guide

For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "aspect_ratio": "21:9",
  "images": [
    [
      "https://example.com/reference.png"
    ]
  ],
  "prompt": "Place the woman leisurely enjoying a cup of espresso while relaxing at a sunlit café table in Siena, Italy. The café setting showcases vintage wooden furniture with peeling white paint, aged brick flooring, and sun-bleached stone walls decorated with trailing ivy and vibrant potted geraniums that capture Siena's medieval character. Golden late-morning light streams through overhead, creating soft shadows that highlight the weathered architectural details. The composition appears slightly off-center, conveying the unguarded tranquility and personal intimacy of a peaceful moment savoring the Tuscan morning ambiance."
}

Technical Specs

SpecValue
Model IDideogram-ai/ideogram-v3/character
Inputsaspect_ratio, images, prompt, reference_images, reference_masks, rendering_speed, seed
Required inputsprompt
Output fieldscontent_type, url
ExecutionAsync (submit, then poll for result)
Aspect Ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16

Related Models

Related Models

ideogram-ai/ideogram-v3/character/editIdeogram V3 Character Edit by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.ideogram-ai/ideogram-v3/character/remixIdeogram V3 Character Remix is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v33.0 is Ideogram's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.ideogram-ai/ideogram-v3/editIdeogram V3 Edit by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.ideogram-ai/ideogram-v3/layerize-textIdeogram V3 Layerize Text is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/reframeIdeogram V3 Reframe is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/remixIdeogram V3 Remix is ideogram-ai's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.ideogram-ai/ideogram-v3/replace-backgroundIdeogram V3 Replace Background by ideogram-ai - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.