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

# Ideogram 3.0 Character

> Generate consistent characters from a single reference photo using Ideogram. Maintains facial features across different scenes and poses.

Model id `ideogram-3.0-character` · Ideogram · image · 1 mode: `reference-to-image`.

> [!NOTE]
>
> This page reflects the current catalog. Inputs, allowed values, limits and prices can change as the model evolves; the field names and their meaning do not. For the exact schema at any time, your agent calls [`get_model`](https://docs.argil.ai/v2/mcp/tools) with the mode.

## Reference To Image

Mode `reference-to-image`. Generate consistent characters from a single reference photo using Ideogram. Maintains facial features across different scenes and poses.

### Input

| Field | Type | Required | Allowed | Default | Description |
| - | - | - | - | - | - |
| `prompt` | string | Yes | | | The scene to put the character in. |
| `rendering_speed` | string | | `TURBO`, `BALANCED`, `QUALITY` | `BALANCED` | Speed / quality tier. |
| `style` | string | | `AUTO`, `REALISTIC`, `FICTION` | | Rendering style. AUTO by default. |
| `image_size` | string | | `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9` | | Output size preset. |
| `negative_prompt` | string | | up to 5,000 characters | | What to avoid in the image. |
| `references` | [File](https://docs.argil.ai/v2/mcp/how-it-works.md#your-files) list | Yes | 1 to 1 items | | References the output must follow. The kind of each one (image, video, audio) is read from the file; per-kind limits are in the mode’s `capabilities.references`. |

**References:** up to 1: 1 images. Assets, URLs and elements are accepted.

### Pricing

4.84–9.68 credits per image (by rendering speed; BALANCED default).

Fixed price: charged as estimated.

For the exact price of a request, use [`estimate_generation`](https://docs.argil.ai/v2/mcp/tools).

### Example

The arguments of [`generate_media`](https://docs.argil.ai/v2/mcp/tools#generate_media):

```json theme={null}
{
  "model": "ideogram-3.0-character",
  "mode": "reference-to-image",
  "input": {
    "prompt": "Studio photo of a ceramic mug with steam, soft morning light, keeping the look of the reference",
    "references": [
      "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24"
    ]
  }
}
```


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