Browse ModelsIdeogram AIIdeogram AI Ideogram Character

Ideogram Ai Ideogram Character

Ideogram Ai Ideogram Character

Playground

Try it on WavespeedAI!

Ideogram Character creates consistent characters from one reference image, in many styles, and supports inpainting to place the character into existing images. Ready-to-use REST API, no coldstarts, affordable pricing.

Features

Ideogram Character

Edit and transform character images with Ideogram’s powerful AI. This specialized model excels at modifying outfits, appearances, and styles while maintaining character consistency and natural lighting — perfect for fashion visualization, character design, and creative transformations.

Why It Looks Great

  • Character-focused editing: Optimized for modifying people and characters while preserving identity.
  • Style modes: Choose from Auto, Fiction, or Realistic styles to match your creative vision.
  • Rendering speed options: Balance between speed and quality with Turbo, Default, or Quality modes.
  • Flexible aspect ratios: Five format options for any use case.
  • Prompt Enhancer: Built-in tool to refine your editing instructions automatically.
  • Safety Checker: Optional content filtering for appropriate output.

Parameters

ParameterRequiredDescription
promptYesText instruction describing the edit you want to make.
imageYesSource image to edit (upload or public URL).
styleNoOutput style: Auto, Fiction, or Realistic. Default: Auto.
rendering_speedNoProcessing mode: Turbo, Default, or Quality. Default: Default.
aspect_ratioNoOutput format: 1:1, 16:9, 9:16, 4:3, or 3:4. Default: 1:1.
enable_base64_outputNoAPI only: Returns base64 string instead of URL.
Enable Safety CheckerNoToggle content safety filtering.

How to Use

  1. Write your edit instruction — describe the changes you want (e.g., outfit, appearance, style).
  2. Use Prompt Enhancer (optional) — click to refine your instruction.
  3. Upload your image — drag and drop or paste a public URL.
  4. Choose style — select Auto, Fiction, or Realistic based on your needs.
  5. Select rendering speed — choose Turbo for speed, Quality for best results, or Default for balance.
  6. Set aspect ratio — pick the output format that fits your use case.
  7. Run — click the button to apply the edit.
  8. Download — preview and save your edited image.

Pricing

Pricing varies by rendering speed.

Rendering SpeedCostBest For
Turbo$0.10Quick previews, rapid iteration, testing concepts
Default$0.15General use, balanced quality and speed
Quality$0.20Final deliverables, maximum detail and refinement

Examples

Rendering Speed5 Images10 Images50 Images
Turbo$0.50$1.00$5.00
Default$0.75$1.50$7.50
Quality$1.00$2.00$10.00

Best Use Cases

  • Fashion & Outfit Changes — Swap clothing, change dress colors, modify accessories.
  • Character Design — Create variations of characters with different looks.
  • Portrait Enhancement — Adjust appearance details while maintaining likeness.
  • Style Exploration — Transform between realistic and fictional aesthetics.
  • Content Creation — Generate multiple outfit or look variations for social media.

Example Prompts

  • “She change the outfit to a red dress, keep the lighting natural”
  • “Change the shirt to a blue business suit”
  • “Add sunglasses and a leather jacket”
  • “Transform into a fantasy warrior with armor”
  • “Change hair color to blonde, keep everything else the same”
  • “Dress in casual summer outfit, white t-shirt and jeans”

Style Guide

StyleDescriptionBest For
AutoAutomatically determines the best styleGeneral use, when unsure
FictionStylized, artistic, illustrative lookFantasy, anime, creative content
RealisticPhotorealistic, natural appearanceFashion, portraits, professional use

Pro Tips for Best Results

  • Be specific about what to change AND what to preserve — “keep the lighting natural”.
  • Use Realistic style for fashion and portrait work, Fiction for creative/fantasy content.
  • Start with Turbo mode to test your prompt, then switch to Quality for the final version.
  • Describe outfit changes in detail — color, style, material, fit.
  • The model preserves facial identity well — focus your prompt on clothing and accessories.
  • Match aspect ratio to your intended platform: 1:1 for profiles, 9:16 for stories, 16:9 for banners.

Notes

  • If using a URL for the image, ensure it is publicly accessible. A preview thumbnail confirms successful loading.
  • The enable_base64_output option is only available through the API.
  • Processing time varies by rendering speed selection.
  • Enable Safety Checker for content that will be publicly shared.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-character" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "style": "Auto",
    "rendering_speed": "Default",
    "aspect_ratio": "1:1",
    "enable_base64_output": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
imagestringYes-An image to use as a character reference.
stylestringNoAutoAuto, Fiction, RealisticThe character style type. Auto, Fiction, or Realistic.
rendering_speedstringNoDefaultDefault, Turbo, QualityRendering speed. Turbo for faster and cheaper generation, quality for higher quality and more expensive generation, default for balanced.
aspect_ratiostringNo1:11:1, 16:9, 9:16, 4:3, 3:4The aspect ratio of the generated media.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.