Ideogram 3.0 Character

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

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 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 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.

Example

The arguments of generate_media:

{
  "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"
    ]
  }
}

Models

Video

Image

Audio

Ideogram 3.0 Character

Reference To Image

Input

Pricing

Example

​Reference To Image

​Input

​Pricing

​Example

Reference To Image

Input

Pricing

Example