Ideogram | Character
Generate images with consistent character appearance using Ideogram. Supports character reference images, inpainting with masks, multiple style types, and a wide range of resolutions.
Quick Start
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "ideogram-character",
"version": "0.0.1",
"input": {
"prompt": "A heroic fantasy warrior standing on a cliff overlooking a vast kingdom",
"aspect_ratio": "4:3",
"style_type": "Fiction",
"rendering_speed": "Default"
}
}'
Parameters
| Parameter |
Type |
Default |
Description |
aspect_ratio |
string |
1:1 |
Aspect ratio. Options: 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 |
character_reference_image |
string |
(empty) |
An image to use as a character reference |
image |
string |
(empty) |
An image file for inpainting. Must also use a mask |
magic_prompt_option |
string |
Auto |
Prompt enhancement. Options: Auto, On, Off |
mask |
string |
(empty) |
A black and white image. Black pixels are inpainted, white pixels are preserved |
prompt |
string |
(empty) |
Text prompt for image generation |
rendering_speed |
string |
Default |
Rendering speed. Options: Default, Turbo, Quality |
resolution |
string |
None |
Specific resolution. Options: None (auto), plus many specific resolutions from 512x1536 to 1536x640 |
seed |
integer |
(empty) |
Random seed for reproducible generation |
style_type |
string |
Auto |
Visual style. Options: Auto, Fiction, Realistic |
Output
Examples
Character with Reference
{
"model": "ideogram-character",
"version": "0.0.1",
"input": {
"prompt": "A detective investigating a crime scene in a noir-style alley",
"character_reference_image": "https://example.com/my-character.jpg",
"aspect_ratio": "16:9",
"style_type": "Realistic",
"rendering_speed": "Quality"
}
}
Fiction Art
{
"model": "ideogram-character",
"version": "0.0.1",
"input": {
"prompt": "An elven archer in an enchanted forest with glowing runes",
"aspect_ratio": "3:4",
"style_type": "Fiction",
"magic_prompt_option": "On",
"seed": 42
}
}
Inpainting
{
"model": "ideogram-character",
"version": "0.0.1",
"input": {
"prompt": "A smiling woman in a red dress",
"image": "https://example.com/scene.jpg",
"mask": "https://example.com/mask.png",
"rendering_speed": "Default"
}
}
Related Models
Documentation
1---2name: ideogram-character3description: Generate character-consistent images using Ideogram with optional inpainting. Trigger: Use when the user wants to create character images, or requests 'ideogram character', 'consistent character', or 'ideogram image generation'.4---56# Ideogram | Character78Generate images with consistent character appearance using Ideogram. Supports character reference images, inpainting with masks, multiple style types, and a wide range of resolutions.910## Quick Start1112```bash13curl -X POST https://api.eachlabs.ai/v1/prediction \14 -H "Content-Type: application/json" \15 -H "X-API-Key: $EACHLABS_API_KEY" \16 -d '{17 "model": "ideogram-character",18 "version": "0.0.1",19 "input": {20 "prompt": "A heroic fantasy warrior standing on a cliff overlooking a vast kingdom",21 "aspect_ratio": "4:3",22 "style_type": "Fiction",23 "rendering_speed": "Default"24 }25 }'26```2728## Parameters2930| Parameter | Type | Default | Description |31|-----------|------|---------|-------------|32| `aspect_ratio` | string | `1:1` | Aspect ratio. Options: `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` |33| `character_reference_image` | string | (empty) | An image to use as a character reference |34| `image` | string | (empty) | An image file for inpainting. Must also use a mask |35| `magic_prompt_option` | string | `Auto` | Prompt enhancement. Options: `Auto`, `On`, `Off` |36| `mask` | string | (empty) | A black and white image. Black pixels are inpainted, white pixels are preserved |37| `prompt` | string | (empty) | Text prompt for image generation |38| `rendering_speed` | string | `Default` | Rendering speed. Options: `Default`, `Turbo`, `Quality` |39| `resolution` | string | `None` | Specific resolution. Options: `None` (auto), plus many specific resolutions from `512x1536` to `1536x640` |40| `seed` | integer | (empty) | Random seed for reproducible generation |41| `style_type` | string | `Auto` | Visual style. Options: `Auto`, `Fiction`, `Realistic` |4243## Output4445- **Type:** image4647## Examples4849### Character with Reference50```json51{52 "model": "ideogram-character",53 "version": "0.0.1",54 "input": {55 "prompt": "A detective investigating a crime scene in a noir-style alley",56 "character_reference_image": "https://example.com/my-character.jpg",57 "aspect_ratio": "16:9",58 "style_type": "Realistic",59 "rendering_speed": "Quality"60 }61}62```6364### Fiction Art65```json66{67 "model": "ideogram-character",68 "version": "0.0.1",69 "input": {70 "prompt": "An elven archer in an enchanted forest with glowing runes",71 "aspect_ratio": "3:4",72 "style_type": "Fiction",73 "magic_prompt_option": "On",74 "seed": 4275 }76}77```7879### Inpainting80```json81{82 "model": "ideogram-character",83 "version": "0.0.1",84 "input": {85 "prompt": "A smiling woman in a red dress",86 "image": "https://example.com/scene.jpg",87 "mask": "https://example.com/mask.png",88 "rendering_speed": "Default"89 }90}91```9293## Related Models9495- [Imagen 4 Preview](../imagen4-preview/SKILL.md) - Google's image generation model96- [Seedream V4 Text to Image](../seedream-v4-text-to-image/SKILL.md) - ByteDance text-to-image97- [Minimax Subject Reference](../minimax-subject-reference/SKILL.md) - Subject-consistent image generation9899## Documentation100101- [EachLabs API Docs](https://docs.eachlabs.ai)
awesome-genmedia