ideogram-ai/ideogram-character

OfficialView on Replicate →

Generate consistent characters from a single reference image. Outputs can be in many styles. You can also use inpainting to add your character to an existing image.

Capabilities

Reference ImagesSeed

Cost

Community model (estimated from hardware time)

Input Parameters

Name	Type	Description	Default	Constraints
`character_reference_image`*	string(uri)	An image to use as a character reference.	`—`	—
`prompt`*	string	Text prompt for image generation	`—`	—
`aspect_ratio`	string	Aspect ratio. Ignored if a resolution or inpainting image is given.	`"1:1"`	1:33:11:22:19:1616:910:1616:102:33:23:44:34:55:41:1
`image`	string(uri)	An image file to use for inpainting. You must also use a mask.	`—`	—
`magic_prompt_option`	string	Magic Prompt will interpret your prompt and optimize it to maximize variety and quality of the images generated. You can also use it to write prompts in different languages.	`"Auto"`	AutoOnOff
`mask`	string(uri)	A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size.	`—`	—
`rendering_speed`	string	Rendering speed. Turbo for faster and cheaper generation, quality for higher quality and more expensive generation, default for balanced.	`"Default"`	DefaultTurboQuality
`resolution`	string	Resolution. Overrides aspect ratio. Ignored if an inpainting image is given.	`"None"`	None512x1536576x1408576x1472576x1536640x1344640x1408640x1472640x1536704x1152704x1216704x1280704x1344704x1408704x1472736x1312768x1088768x1216768x1280768x1344800x1280832x960832x1024832x1088832x1152832x1216832x1248864x1152896x960896x1024896x1088896x1120896x1152960x832960x896960x1024960x10881024x8321024x8961024x9601024x10241088x7681088x8321088x8961088x9601120x8961152x7041152x8321152x8641152x8961216x7041216x7681216x8321248x8321280x7041280x7681280x8001312x7361344x6401344x7041344x7681408x5761408x6401408x7041472x5761472x6401472x7041536x5121536x5761536x640
`seed`	integer	Random seed. Set for reproducible generation	`—`	max: 2147483647
`style_type`	string	The character style type. Auto, Fiction, or Realistic.	`"Auto"`	AutoFictionRealistic

character_reference_imagerequiredstring

An image to use as a character reference.

promptrequiredstring

Text prompt for image generation

aspect_ratiostring

Aspect ratio. Ignored if a resolution or inpainting image is given.

Default: "1:1"

1:33:11:22:19:1616:910:1616:102:33:23:44:34:55:41:1

imagestring

An image file to use for inpainting. You must also use a mask.

magic_prompt_optionstring

Magic Prompt will interpret your prompt and optimize it to maximize variety and quality of the images generated. You can also use it to write prompts in different languages.

Default: "Auto"

AutoOnOff

maskstring

A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size.

rendering_speedstring

Rendering speed. Turbo for faster and cheaper generation, quality for higher quality and more expensive generation, default for balanced.

Default: "Default"

DefaultTurboQuality

resolutionstring

Resolution. Overrides aspect ratio. Ignored if an inpainting image is given.

Default: "None"

None512x1536576x1408576x1472576x1536640x1344640x1408640x1472640x1536704x1152704x1216704x1280704x1344704x1408704x1472736x1312768x1088768x1216768x1280768x1344800x1280832x960832x1024832x1088832x1152832x1216832x1248864x1152896x960896x1024896x1088896x1120896x1152960x832960x896960x1024960x10881024x8321024x8961024x9601024x10241088x7681088x8321088x8961088x9601120x8961152x7041152x8321152x8641152x8961216x7041216x7681216x8321248x8321280x7041280x7681280x8001312x7361344x6401344x7041344x7681408x5761408x6401408x7041472x5761472x6401472x7041536x5121536x5761536x640

seedinteger

Random seed. Set for reproducible generation

max: 2147483647

style_typestring

The character style type. Auto, Fiction, or Realistic.

Default: "Auto"

AutoFictionRealistic

Version: 1f8e198263a0Updated: 7/25/2026534.9K runs