← All models
Ideogram V3 Character
ideogram-character
Image generationby ideogram
Generate consistent character appearances across multiple images. Maintain facial features, proportions, and distinctive traits for cohesive storytelling and branding
images
Pricing
- Price
- 6.25 cr / image
Prices in credits (1 credit = $0.01).
Data schema
Input
| Field | Type | Description |
|---|---|---|
| seed | — | Seed for the random number generator |
| style | stringenum: AUTO, REALISTIC, FICTION | The style type to generate with. Cannot be used with style_codes. |
| promptrequired | string | The prompt to fill the masked part of the image. |
| sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. |
| image_size | — | The resolution of the generated image |
| image_urls | — | A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format |
| num_images | integer | Number of images to generate. |
| style_codes | — | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style |
| color_palette | — | A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members) |
| expand_prompt | boolean | Determine if MagicPrompt should be used in generating the request or not. |
| negative_prompt | string | Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. |
| rendering_speed | stringenum: TURBO, BALANCED, QUALITY | The rendering speed to use. |
| reference_mask_urls | array | A set of masks to apply to the character references. Currently only 1 mask is supported, rest will be ignored. (maximum total size 10MB across all character references). The masks should be in JPEG, PNG or WebP format |
| reference_image_urlsrequired | array | A set of images to use as character references. Currently only 1 image is supported, rest will be ignored. (maximum total size 10MB across all character references). The images should be in JPEG, PNG or WebP format |
Output
| Field | Type | Description |
|---|---|---|
| seed | integer | Seed used for the random number generator |
| images | array |