cinemasetfree.com
ideogram-ai/ideogram-character
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
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:3 3:1 1:2 2:1 9:16 16:9 10:16 16:10 2:3 3:2 3:4 4:3 4:5 5:4 1: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" | Auto On Off |
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" | Default Turbo Quality |
resolution | string | Resolution. Overrides aspect ratio. Ignored if an inpainting image is given. | "None" | None 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 960x832 960x896 960x1024 960x1088 1024x832 1024x896 1024x960 1024x1024 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 |
seed | integer | Random seed. Set for reproducible generation | — | max: 2147483647 |
style_type | string | The character style type. Auto, Fiction, or Realistic. | "Auto" | Auto Fiction Realistic |
character_reference_image required string An image to use as a character reference.
prompt required string Text prompt for image generation
aspect_ratio string Aspect ratio. Ignored if a resolution or inpainting image is given.
"1:1" image string 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" mask string 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" resolution string Resolution. Overrides aspect ratio. Ignored if an inpainting image is given.
"None" seed integer Random seed. Set for reproducible generation
style_type string The character style type. Auto, Fiction, or Realistic.
"Auto" 1f8e198263a0 Updated: 2/26/2026 534.9K runs