Image
Ideogram Character
Place a reference character into a described scene with Ideogram Character.
- Image editing
Sign in to create. Review the credit cost in the studio before running.
Catalog preview for Ideogram Character. Review your own result before publishing.
A starting point.
Place a reference character into a described scene with Ideogram Character. Describe the pose and surroundings without relying on the reference to explain the whole scene.
Before you publish.
Compare facial features, clothing and proportions with the reference. Character resemblance is a result to inspect, not a guarantee.
Review the quote before running. A failed generation releases its reserved credits. Download the results you want to keep; stored media is retained for 30 days.
Settings and model questionsCheck the available settings and guidance when preparing your input.
Inputs and settings
Provide prompt and one character image in reference_image_urls. The provider uses only the first character reference; image_urls supplies separate style references.
Choose style or style_codes rather than combining them. Record expand_prompt and rendering_speed, and begin with num_images set to 1.
Inputs, all modes and APIModel IDs, current input limits and the API generation workflow.
Supported inputs
These fields come from the current studio form for ideogram/character. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
prompt | Text | Required | — |
reference_image_urls | List | Required | — |
expand_prompt | On/off | Optional | — |
image_urls | List | Optional | — |
negative_prompt | Text | Optional | — |
num_images | Whole number | Optional | ≥ 1 · ≤ 8 |
reference_mask_urls | List | Optional | — |
rendering_speed | Text | Optional | — |
seed | Whole number | Optional | — |
style | Text | Optional | AUTO, REALISTIC, FICTION |
style_codes | List | Optional | — |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
Other modes and their inputs
Open the operation you need and check its inputs. Settings from one mode do not automatically apply to another.
image-to-image (edit)ideogram/character/edit
Supported inputs
These fields come from the current studio form for ideogram/character/edit. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
image_url | Text | Required | — |
mask_url | Text | Required | — |
prompt | Text | Required | — |
reference_image_urls | List | Required | — |
expand_prompt | On/off | Optional | — |
image_urls | List | Optional | — |
num_images | Whole number | Optional | ≥ 1 · ≤ 8 |
reference_mask_urls | List | Optional | — |
rendering_speed | Text | Optional | — |
seed | Whole number | Optional | — |
style_codes | List | Optional | — |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
image-to-image (remix)ideogram/character/remix
Supported inputs
These fields come from the current studio form for ideogram/character/remix. Other modes may require different inputs.
| Input | Type | Requirement | Options and limits |
|---|---|---|---|
image_url | Text | Required | — |
prompt | Text | Required | — |
reference_image_urls | List | Required | — |
expand_prompt | On/off | Optional | — |
image_urls | List | Optional | — |
negative_prompt | Text | Optional | — |
num_images | Whole number | Optional | ≥ 1 · ≤ 8 |
reference_mask_urls | List | Optional | — |
rendering_speed | Text | Optional | — |
seed | Whole number | Optional | — |
strength | Number | Optional | ≥ 0.01 · ≤ 1 |
style | Text | Optional | AUTO, REALISTIC, FICTION |
style_codes | List | Optional | — |
Check the full model schema for all options and cross-field rules. Request a quote for your selected settings before generating.
Use Ideogram Character through the API.
Start with this model ID for the endpoint featured on this page:
ideogram/character
Input requirements belong to this model ID. Check a different mode’s schema separately when switching modes.
Available modes
- image-to-image ·
ideogram/character - image-to-image (edit) ·
ideogram/character/edit - image-to-image (remix) ·
ideogram/character/remix
Check the current model schema for supported inputs and options. Other tasks may use different model IDs.
From quote to result.
Request a credit quote for your input and settings before submitting a generation. A sample output or the price of another model is not a quote for your request.
Follow the generation workflow, then poll the job for its status and result. The API and studio use the same balance.