ideogram-ai/ideogram-character 🖼️🔢📝❓ → 🖼️

⭐ Official ▶️ 299.5K runs 📅 Aug 2025 ⚙️ Cog 0.16.7

image-consistent-character-generation image-inpainting image-to-image

About

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.

Example Output

Prompt:

"a close up photo of a woman in a fashion magazine photoshoot"

Output

Performance Metrics

14.48s Prediction Time

14.49s Total Time

All Input Parameters

{
  "prompt": "a close up photo of a woman in a fashion magazine photoshoot",
  "resolution": "None",
  "style_type": "Auto",
  "aspect_ratio": "1:1",
  "magic_prompt_option": "Auto",
  "character_reference_image": "https://replicate.delivery/pbxt/NUKxQppU8C2sCfleK0lGVI0vt9P3swKz3MnKs1z9fnHkdAV2/0_1.webp"
}

Input Parameters

mask Type: string: A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size.
seed Type: integerRange: ∞ - 2147483647: Random seed. Set for reproducible generation
image Type: string: An image file to use for inpainting. You must also use a mask.
prompt (required) Type: string: Text prompt for image generation
resolution Default: None: Resolution. Overrides aspect ratio. Ignored if an inpainting image is given.
style_type Default: Auto: The character style type. Auto, Fiction, or Realistic.
aspect_ratio Default: 1:1: Aspect ratio. Ignored if a resolution or inpainting image is given.
rendering_speed Default: Default: Rendering speed. Turbo for faster and cheaper generation, quality for higher quality and more expensive generation, default for balanced.
magic_prompt_option Default: Auto: 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.
character_reference_image (required) Type: string: An image to use as a character reference.

Output Schema

Output

Type: string • Format: uri

Example Execution Logs

Using seed: 144578042
Using seed: 144578042
Generating...
Prompt used: A striking fashion photograph showcasing a beautiful woman in a meticulously styled editorial setting. She is gazing intently upwards with an air of sophisticated contemplation, her expression both thoughtful and alluring. The woman wears a minimalist black turtleneck sweater, the smooth fabric contrasting with her porcelain skin and delicate features. Soft, diffused lighting illuminates the scene, casting subtle shadows and enhancing the overall elegance and timelessness of the image.
Image generation took 12.99 seconds
Downloading 1158199 bytes
Downloaded 1.10MB in 0.76sec

Version Details

Version ID: 77d8da192375ce51fa632db399ba3765e6f08da36890f0be5e3e479e09dd79ea
Version Created: September 30, 2025

Run on Replicate →