> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ekly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ideogram Character

> Ideogram character consistency model — generate images with consistent character identity from reference images.

Ideogram character consistency model — generate images with consistent character identity from reference images.

| | |
| - | - |
| Model id | `ideogram-character-fal` |
| Media | image |
| Submit to | `POST /v1/images` |
| Price | 16 credits per\_generation before discounts |
| Typical time | about 20.0 s |

## Request

**Required:** `prompt`\
**Optional:** `aspect_ratio`, `reference_images`

```json theme={null}
{
  "model": "ideogram-character-fal",
  "prompt": "Three-quarter character sheet of an Indian uncle in a cream kurta, clean forehead, soft studio key, seamless warm grey backdrop, photoreal, 50mm. No text.",
  "aspect_ratio": "1:1"
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`, `10:16`, `16:10` | `"1:1"` |
| `reference_images` | asset ids (up to 3) | |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/ideogram-character-fal` is always current.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.