--- title: Ideogram | Scenario Docs --- > This page is auto-generated from model configurations. Last updated: 2026-04-09. This reference lists all available **Ideogram** image generation models and their parameters. Use these parameter names when calling the [Generation API](/api/postgeneratecustom/index.md). - [Ideogram Character](#ideogram-character) - [Ideogram V3 Balanced](#ideogram-v3-balanced) - [Ideogram V3 Generate Transparent](#ideogram-v3-generate-transparent) - [Ideogram V3 Layerize Text](#ideogram-v3-layerize-text) - [Ideogram V3 Quality](#ideogram-v3-quality) - [Ideogram V3 Turbo](#ideogram-v3-turbo) --- ## Ideogram Character **Model ID:** `model_ideogram-character` **Capabilities:** `img2img` **LLM Markdown:** | Parameter | Type | Required | Default | Min | Max | Allowed Values | Description | | ------------------------- | ------ | -------- | --------- | --- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `prompt` | string | Yes | - | - | - | - | Text prompt for image generation | | `renderingSpeed` | string | No | `Default` | - | - | `Default`, `Turbo`, `Quality` | Turbo for faster and cheaper generation, quality for higher quality and more expensive generation, default for balanced. | | `characterReferenceImage` | file | Yes | - | - | - | - | An image to use as a character reference. | | `styleType` | string | No | `Auto` | - | - | `Auto`, `Fiction`, `Realistic` | The character style type. Auto, Fiction, or Realistic. | | `aspectRatio` | string | No | `4:3` | - | - | `1:3`, `1:2`, `2:3`, `3:4`, `4:5`, `9:16`, `10:16`, `1:1`, `3:2`, `4:3`, `5:4`, `16:10`, `16:9`, `2:1`, `3:1` | Aspect ratio. Ignored if a resolution or inpainting image is given. | | `resolution` | string | No | `None` | - | - | `None`, `1536x512`, `1472x576`, `1408x528`, `1408x704`, `1280x720`, `1280x768`, `1024x768`, `1024x1024`, `768x1024`, `832x1472`, `704x1408`, `512x1536` | Resolution. Overrides aspect ratio. Ignored if an inpainting image is given. | | `image` | file | No | - | - | - | - | An image file to use for inpainting. You must also use a mask. | | `mask` | file | No | - | - | - | - | A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size. | | `seed` | number | No | - | - | 2147483647 | - | Use a seed for reproducible results. Leave blank to use a random seed. | ## Ideogram V3 Balanced Ideogram v3 balanced: Balance speed, quality and cost. Ideogram v3 creates images with stunning realism, creative designs, and consistent styles. **Model ID:** `model_ideogram-v3-balanced` **Capabilities:** `txt2img`, `img2img` **LLM Markdown:** | Parameter | Type | Required | Default | Min | Max | Allowed Values | Description | | ---------------------- | ----------- | -------- | ------- | --- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `prompt` | string | Yes | - | - | - | - | Describe your image | | `aspectRatio` | string | No | `4:3` | - | - | `1:3`, `1:2`, `2:3`, `3:4`, `4:5`, `9:16`, `10:16`, `1:1`, `5:4`, `4:3`, `3:2`, `16:10`, `16:9`, `2:1`, `3:1` | Aspect ratio. Ignored if a resolution or inpainting image is given. | | `resolution` | string | No | `None` | - | - | `None`, `512x1536`, `576x1408`, `640x1344`, `704x1344`, `768x1344`, `832x1216`, `896x1152`, `960x1024`, `1024x1024`, `1088x960`, `1152x896`, `1216x832`, `1280x768`, `1344x704`, `1408x640`, `1472x576`, `1536x512` | Resolution. Overrides aspect ratio. Ignored if an inpainting image is given. | | `magicPromptOption` | string | No | `Auto` | - | - | `Auto`, `On`, `Off` | Magic Prompt will interpret your prompt and optimize it to maximize variety and quality of the images generated. You can also use it to write prompts in different languages. | | `image` | file | No | - | - | - | - | An image file to use for inpainting. You must also use a mask. | | `mask` | file | No | - | - | - | - | A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size. | | `styleReferenceImages` | file\_array | No | - | - | - | - | A list of images to use as style references. | | `styleType` | string | No | `None` | - | - | `None`, `Auto`, `General`, `Realistic`, `Design` | The styles help define the specific aesthetic of the image you want to generate. | | `stylePreset` | string | No | `None` | - | - | `None`, `80s Illustration`, `90s Nostalgia`, `Abstract Organic`, `Analog Nostalgia`, `Art Brut`, `Art Deco`, `Art Poster`, `Aura`, `Avant Garde`, `Bauhaus`, `Blueprint`, `Blurry Motion`, `Bright Art`, `C4D Cartoon`, `Children's Book`, `Collage`, `Coloring Book I`, `Coloring Book II`, `Cubism`, `Dark Aura`, `Doodle`, `Double Exposure`, `Dramatic Cinema`, `Editorial`, `Emotional Minimal`, `Ethereal Party`, `Expired Film`, `Flat Art`, `Flat Vector`, `Forest Reverie`, `Geo Minimalist`, `Glass Prism`, `Golden Hour`, `Graffiti I`, `Graffiti II`, `Halftone Print`, `High Contrast`, `Hippie Era`, `Iconic`, `Japandi Fusion`, `Jazzy`, `Long Exposure`, `Magazine Editorial`, `Minimal Illustration`, `Mixed Media`, `Monochrome`, `Nightlife`, `Oil Painting`, `Old Cartoons`, `Paint Gesture`, `Pop Art`, `Retro Etching`, `Riviera Pop`, `Spotlight 80s`, `Stylized Red`, `Surreal Collage`, `Travel Poster`, `Vintage Geo`, `Vintage Poster`, `Watercolor`, `Weird`, `Woodblock Print` | The style preset to use for the image generation. | | `seed` | number | No | - | 0 | 2147483647 | - | Use a seed for reproducible results. Leave blank to use a random seed. | ## Ideogram V3 Generate Transparent Generate images with transparent backgrounds using Ideogram V3. **Model ID:** `model_ideogram-v3-generate-transparent` **Capabilities:** `txt2img` **LLM Markdown:** | Parameter | Type | Required | Default | Min | Max | Allowed Values | Description | | ---------------- | ------- | -------- | ---------- | --- | ---------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | `prompt` | string | Yes | - | - | - | - | Text prompt describing the image to generate. | | `negativePrompt` | string | No | - | - | - | - | Description of what should not appear in the generated image. | | `aspectRatio` | string | No | `1:1` | - | - | `1:3`, `1:2`, `9:16`, `10:16`, `2:3`, `3:4`, `4:5`, `1:1`, `5:4`, `4:3`, `3:2`, `16:10`, `16:9`, `2:1`, `3:1` | Aspect ratio for the generated image. | | `renderingSpeed` | string | No | `BALANCED` | - | - | `FLASH`, `TURBO`, `BALANCED`, `QUALITY` | Speed and quality tier for image generation. | | `expandPrompt` | boolean | No | `true` | - | - | - | Enable Magic Prompt expansion before generation. | | `numOutputs` | number | No | `1` | 1 | 8 | - | Number of images to generate. | | `seed` | number | No | - | 0 | 2147483647 | - | Seed for reproducible generation. | ## Ideogram V3 Layerize Text Remove text from flat graphics and return editable text layer metadata. **Model ID:** `model_ideogram-v3-layerize-text` **Capabilities:** `img2img` **LLM Markdown:** | Parameter | Type | Required | Default | Min | Max | Allowed Values | Description | | --------------- | ------ | -------- | ------- | --- | ---------- | -------------- | ----------------------------------------------------------------- | | `image` | file | Yes | - | - | - | - | Flat graphic image to layerize. | | `prompt` | string | No | - | - | - | - | Optional prompt to guide the layerization process. | | `seed` | number | No | - | 0 | 2147483647 | - | Seed for reproducible layerization. | | `fontNameH1` | string | No | - | - | - | - | Optional font name for h1 text. | | `fontNameH2` | string | No | - | - | - | - | Optional font name for h2 text. | | `fontNameBody` | string | No | - | - | - | - | Optional font name for body text. | | `fontNameSmall` | string | No | - | - | - | - | Optional font name for small text. Cannot be used with font file. | | `fontFileH1` | string | No | - | - | - | - | Optional font file for h1 text. Cannot be used with font name. | | `fontFileH2` | string | No | - | - | - | - | Optional font file for h2 text. Cannot be used with font name. | | `fontFileBody` | string | No | - | - | - | - | Optional font file for body text. Cannot be used with font name. | | `fontFileSmall` | string | No | - | - | - | - | Optional font file for small text. Cannot be used with font name. | ## Ideogram V3 Quality The highest quality Ideogram v3 model. v3 creates images with stunning realism, creative designs, and consistent styles. **Model ID:** `model_ideogram-v3-quality` **Capabilities:** `txt2img`, `img2img` **LLM Markdown:** | Parameter | Type | Required | Default | Min | Max | Allowed Values | Description | | ---------------------- | ----------- | -------- | ------- | --- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `prompt` | string | Yes | - | - | - | - | Describe your image | | `aspectRatio` | string | No | `4:3` | - | - | `1:3`, `1:2`, `2:3`, `3:4`, `4:5`, `9:16`, `10:16`, `1:1`, `5:4`, `4:3`, `3:2`, `16:10`, `16:9`, `2:1`, `3:1` | Aspect ratio. Ignored if a resolution or inpainting image is given. | | `resolution` | string | No | `None` | - | - | `None`, `512x1536`, `576x1408`, `640x1344`, `704x1344`, `768x1344`, `832x1216`, `896x1152`, `960x1024`, `1024x1024`, `1088x960`, `1152x896`, `1216x832`, `1280x768`, `1344x704`, `1408x640`, `1472x576`, `1536x512` | Resolution. Overrides aspect ratio. Ignored if an inpainting image is given. | | `magicPromptOption` | string | No | `Auto` | - | - | `Auto`, `On`, `Off` | Magic Prompt will interpret your prompt and optimize it to maximize variety and quality of the images generated. You can also use it to write prompts in different languages. | | `image` | file | No | - | - | - | - | An image file to use for inpainting. You must also use a mask. | | `mask` | file | No | - | - | - | - | A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size. | | `styleReferenceImages` | file\_array | No | - | - | - | - | A list of images to use as style references. | | `styleType` | string | No | `None` | - | - | `None`, `Auto`, `General`, `Realistic`, `Design` | The styles help define the specific aesthetic of the image you want to generate. | | `stylePreset` | string | No | `None` | - | - | `None`, `80s Illustration`, `90s Nostalgia`, `Abstract Organic`, `Analog Nostalgia`, `Art Brut`, `Art Deco`, `Art Poster`, `Aura`, `Avant Garde`, `Bauhaus`, `Blueprint`, `Blurry Motion`, `Bright Art`, `C4D Cartoon`, `Children's Book`, `Collage`, `Coloring Book I`, `Coloring Book II`, `Cubism`, `Dark Aura`, `Doodle`, `Double Exposure`, `Dramatic Cinema`, `Editorial`, `Emotional Minimal`, `Ethereal Party`, `Expired Film`, `Flat Art`, `Flat Vector`, `Forest Reverie`, `Geo Minimalist`, `Glass Prism`, `Golden Hour`, `Graffiti I`, `Graffiti II`, `Halftone Print`, `High Contrast`, `Hippie Era`, `Iconic`, `Japandi Fusion`, `Jazzy`, `Long Exposure`, `Magazine Editorial`, `Minimal Illustration`, `Mixed Media`, `Monochrome`, `Nightlife`, `Oil Painting`, `Old Cartoons`, `Paint Gesture`, `Pop Art`, `Retro Etching`, `Riviera Pop`, `Spotlight 80s`, `Stylized Red`, `Surreal Collage`, `Travel Poster`, `Vintage Geo`, `Vintage Poster`, `Watercolor`, `Weird`, `Woodblock Print` | The style preset to use for the image generation. | | `seed` | number | No | - | 0 | 2147483647 | - | Use a seed for reproducible results. Leave blank to use a random seed. | ## Ideogram V3 Turbo Turbo is the fastest and cheapest Ideogram v3. v3 creates images with stunning realism, creative designs, and consistent styles **Model ID:** `model_ideogram-v3-turbo` **Capabilities:** `txt2img`, `img2img` **LLM Markdown:** | Parameter | Type | Required | Default | Min | Max | Allowed Values | Description | | ---------------------- | ----------- | -------- | ------- | --- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `prompt` | string | Yes | - | - | - | - | Describe your image | | `aspectRatio` | string | No | `4:3` | - | - | `1:3`, `1:2`, `2:3`, `3:4`, `4:5`, `9:16`, `10:16`, `1:1`, `5:4`, `4:3`, `3:2`, `16:10`, `16:9`, `2:1`, `3:1` | Aspect ratio. Ignored if a resolution or inpainting image is given. | | `resolution` | string | No | `None` | - | - | `None`, `512x1536`, `576x1408`, `640x1344`, `704x1344`, `768x1344`, `832x1216`, `896x1152`, `960x1024`, `1024x1024`, `1088x960`, `1152x896`, `1216x832`, `1280x768`, `1344x704`, `1408x640`, `1472x576`, `1536x512` | Resolution. Overrides aspect ratio. Ignored if an inpainting image is given. | | `magicPromptOption` | string | No | `Auto` | - | - | `Auto`, `On`, `Off` | Magic Prompt will interpret your prompt and optimize it to maximize variety and quality of the images generated. You can also use it to write prompts in different languages. | | `image` | file | No | - | - | - | - | An image file to use for inpainting. You must also use a mask. | | `mask` | file | No | - | - | - | - | A black and white image. Black pixels are inpainted, white pixels are preserved. The mask will be resized to match the image size. | | `styleReferenceImages` | file\_array | No | - | - | - | - | A list of images to use as style references. | | `styleType` | string | No | `None` | - | - | `None`, `Auto`, `General`, `Realistic`, `Design` | The styles help define the specific aesthetic of the image you want to generate. | | `stylePreset` | string | No | `None` | - | - | `None`, `80s Illustration`, `90s Nostalgia`, `Abstract Organic`, `Analog Nostalgia`, `Art Brut`, `Art Deco`, `Art Poster`, `Aura`, `Avant Garde`, `Bauhaus`, `Blueprint`, `Blurry Motion`, `Bright Art`, `C4D Cartoon`, `Children's Book`, `Collage`, `Coloring Book I`, `Coloring Book II`, `Cubism`, `Dark Aura`, `Doodle`, `Double Exposure`, `Dramatic Cinema`, `Editorial`, `Emotional Minimal`, `Ethereal Party`, `Expired Film`, `Flat Art`, `Flat Vector`, `Forest Reverie`, `Geo Minimalist`, `Glass Prism`, `Golden Hour`, `Graffiti I`, `Graffiti II`, `Halftone Print`, `High Contrast`, `Hippie Era`, `Iconic`, `Japandi Fusion`, `Jazzy`, `Long Exposure`, `Magazine Editorial`, `Minimal Illustration`, `Mixed Media`, `Monochrome`, `Nightlife`, `Oil Painting`, `Old Cartoons`, `Paint Gesture`, `Pop Art`, `Retro Etching`, `Riviera Pop`, `Spotlight 80s`, `Stylized Red`, `Surreal Collage`, `Travel Poster`, `Vintage Geo`, `Vintage Poster`, `Watercolor`, `Weird`, `Woodblock Print` | The style preset to use for the image generation. | | `seed` | number | No | - | 0 | 2147483647 | - | Use a seed for reproducible results. Leave blank to use a random seed. |