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

Parameter	Required	Description
prompt	Yes	Text instruction describing the edit you want to make.
image	Yes	Source image to edit (upload or public URL).
style	No	Output style: Auto, Fiction, or Realistic. Default: Auto.
rendering_speed	No	Processing mode: Turbo, Default, or Quality. Default: Default.
aspect_ratio	No	Output format: 1:1, 16:9, 9:16, 4:3, or 3:4. Default: 1:1.
enable_base64_output	No	API only: Returns base64 string instead of URL.
Enable Safety Checker	No	Toggle content safety filtering.

How to Use

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

Pricing

Pricing varies by rendering speed.

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

Examples

Rendering Speed	5 Images	10 Images	50 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

Style	Description	Best For
Auto	Automatically determines the best style	General use, when unsure
Fiction	Stylized, artistic, illustrative look	Fantasy, anime, creative content
Realistic	Photorealistic, natural appearance	Fashion, 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.

Ideogram Character API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-character with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Ideogram Character below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-character" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "style": "Auto",
    "rendering_speed": "Default",
    "aspect_ratio": "1:1",
    "enable_base64_output": false
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey, {
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

try {
  const result = await client.run("ideogram-ai/ideogram-character", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "image": "https://example.com/your-input.jpg",
        "style": "Auto",
        "rendering_speed": "Default",
        "aspect_ratio": "1:1",
        "enable_base64_output": false
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(
    api_key=os.environ["WAVESPEED_API_KEY"],
    max_connection_retries=5,
    retry_interval=1.0,
)

try:
    output = client.run(
        "ideogram-ai/ideogram-character",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "style": "Auto",
    "rendering_speed": "Default",
    "aspect_ratio": "1:1",
    "enable_base64_output": false
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Ideogram Character API — Frequently asked questions

What is the Ideogram Character API?

Ideogram Character is a Ideogram model for image editing, exposed as a REST API 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. You can call it programmatically or try it from the playground above.

How do I call the Ideogram Character API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-ai-ideogram-character.

How much does Ideogram Character cost per run?

Ideogram Character starts at $0.15 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Ideogram Character accept?

Key inputs: `prompt`, `image`, `aspect_ratio`, `enable_base64_output`, `rendering_speed`, `style`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-ai-ideogram-character.

How long does Ideogram Character take to generate?

Average end-to-end generation time on WaveSpeedAI is around 17 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Ideogram Character outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Ideogram). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

예시전체 보기

관련 모델

README