ideogram-mcp

Reframe an image

ideogram_reframe

Extend an image to a new size using outpainting with Ideogram 3.0 or Nano Banana 2. Results are saved to the output directory; price a call first with ideogram_quote.

Instructions

Extend an image to a new size by outpainting (Ideogram 3.0 or Nano Banana 2). Results are saved to the output directory; ideogram_quote prices a call first (nothing is generated).

Input Schema

Name	Required	Description
`seed`	No	Random seed for a reproducible result
`image`	No	Local image file to work on, or a public https URL of one
`model`	No	The model (default ideogram-3); each takes the fields of its variant below
`wait_s`	No	Seconds to wait for the result (0-50, default 45). The job is accepted first; if it is still running when the wait ends, the result is its generation_id for ideogram_generation (never resubmitted, never billed twice).
`private`	No	Keep the result out of Ideogram's public feed; true unless you set false (enterprise accounts are always private)
`num_images`	No	How many images to make (each is billed)
`resolution`	No	Exact output size WIDTHxHEIGHT from the model's list; not with aspect_ratio
`style_codes`	No	8-character hexadecimal style codes
`aspect_ratio`	No	Output aspect ratio such as 16x9; not with resolution
`style_preset`	No	A named style preset; not with style codes or style references
`color_palette`	No	A preset palette by name, or explicit hex colours with weights
`inline_images`	No	true: each saved image is also returned as image content (base64; one over 3.75 MB, or past 10 MB in total, by path only), for a client without file access
`rendering_speed`	No	turbo, default or quality: faster is cheaper
`image_asset_identifier`	No	An Ideogram asset (an upload or an earlier result) instead of a local image
`style_reference_images`	No	Local image files (or public https URLs) whose style the result follows
`style_reference_asset_identifiers`	No	Ideogram assets (uploads or earlier results) to use as style references

Schema Changelog

Changes observed during successful MCP inspections.

Changed32 schema fields changedv2.5.0Oct 12, 2026

addedInput schema / additionalProperties
```
Added value: +{}
```

addedInput schema / definitions

Added value: +{
+  "__schema0": {
+    "properties": {
+      "color_hex": {
+        "pattern": "^#(?:[0-9a-fA-F]{3}){1,2}$",
+        "type": "string"
+      },
+      "color_weight": {
+        "maximum": 1,
+        "minimum": 0.05,
+        "type": "number"
+      }
+    },
+    "required": [
+      "color_hex"
+    ],
+    "type": "object"
+  },
+  "__schema1": {
+    "properties": {
+      "asset_id": {
+        "type": "string"
+      },
+      "asset_type": {
+        "enum": [
+          "ASSET",
+          "CANVAS_ASSET",
+          "LAYERED_ASSET",
+          "RESPONSE",
+          "UPLOAD"
+        ],
+        "type": "string"
+      },
+      "collection_id": {
+        "maxLength": 22,
+        "minLength": 22,
+        "pattern": "^[A-Za-z0-9_-]{22}$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "asset_id",
+      "asset_type"
+    ],
+    "type": "object"
+  },
+  "shared0": {
+    "maximum": 2147483647,
+    "minimum": 0,
+    "type": "integer"
+  }
+}

addedInput schema / oneOf

Added value: +[
+  {
+    "properties": {
+      "color_palette": {
+        "anyOf": [
+          {
+            "properties": {
+              "name": {
+                "enum": [
+                  "ember",
+                  "fresh",
+                  "jungle",
+                  "magic",
+                  "melon",
+                  "mosaic",
+                  "pastel",
+                  "ultramarine"
+                ],
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "type": "object"
+          },
+          {
+            "properties": {
+              "members": {
+                "items": {
+                  "$ref": "#/definitions/__schema0"
+                },
+                "maxItems": 8,
+                "minItems": 1,
+                "type": "array"
+              }
+            },
+            "required": [
+              "members"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "image": {
+        "type": "string"
+      },
+      "image_asset_identifier": {
+        "$ref": "#/definitions/__schema1"
+      },
+      "model": {
+        "const": "ideogram-3",
+        "type": "string"
+      },
+      "num_images": {
+        "default": 1,
+        "maximum": 8,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "rendering_speed": {
+        "default": "default",
+        "enum": [
+          "turbo",
+          "default",
+          "quality"
+        ],
+        "type": "string"
+      },
+      "resolution": {
+        "enum": [
+          "512x1536",
+          "576x1408",
+          "576x1472",
+          "576x1536",
+          "640x1344",
+          "640x1408",
+          "640x1472",
+          "640x1536",
+          "704x1152",
+          "704x1216",
+          "704x1280",
+          "704x1344",
+          "704x1408",
+          "704x1472",
+          "736x1312",
+          "768x1088",
+          "768x1216",
+          "768x1280",
+          "768x1344",
+          "800x1280",
+          "832x960",
+          "832x1024",
+          "832x1088",
+          "832x1152",
+          "832x1216",
+          "832x1248",
+          "864x1152",
+          "896x960",
+          "896x1024",
+          "896x1088",
+          "896x1120",
+          "896x1152",
+          "960x832",
+          "960x896",
+          "960x1024",
+          "960x1088",
+          "1024x832",
+          "1024x896",
+          "1024x960",
+          "1024x1024",
+          "1088x768",
+          "1088x832",
+          "1088x896",
+          "1088x960",
+          "1120x896",
+          "1152x704",
+          "1152x832",
+          "1152x864",
+          "1152x896",
+          "1216x704",
+          "1216x768",
+          "1216x832",
+          "1248x832",
+          "1280x704",
+          "1280x768",
+          "1280x800",
+          "1312x736",
+          "1344x640",
+          "1344x704",
+          "1344x768",
+          "1408x576",
+          "1408x640",
+          "1408x704",
+          "1472x576",
+          "1472x640",
+          "1472x704",
+          "1536x512",
+          "1536x576",
+          "1536x640"
+        ],
+        "type": "string"
+      },
+      "seed": {
+        "$ref": "#/definitions/shared0"
+      },
+      "style_codes": {
+        "items": {
+          "pattern": "^[0-9a-fA-F]{8}$",
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "style_preset": {
+        "enum": [
+          "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",
+          "childrens_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"
+        ],
+        "type": "string"
+      },
+      "style_reference_asset_identifiers": {
+        "items": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "maxItems": 10,
+        "minItems": 1,
+        "type": "array"
+      },
+      "style_reference_images": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 10,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "resolution"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "aspect_ratio": {
+        "enum": [
+          "1:1",
+          "3:2",
+          "2:3",
+          "4:3",
+          "3:4",
+          "5:4",
+          "4:5",
+          "16:9",
+          "9:16",
+          "21:9",
+          "4:1",
+          "1:4",
+          "8:1",
+          "1:8"
+        ],
+        "type": "string"
+      },
+      "image": {
+        "type": "string"
+      },
+      "image_asset_identifier": {
+        "$ref": "#/definitions/__schema1"
+      },
+      "model": {
+        "const": "nano-banana-2",
+        "type": "string"
+      },
+      "num_images": {
+        "default": 1,
+        "maximum": 4,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "private": {
+        "type": "boolean"
+      },
+      "seed": {
+        "$ref": "#/definitions/shared0"
+      }
+    },
+    "required": [
+      "model",
+      "aspect_ratio"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / aspect_ratio

Added value: +{
+  "description": "Output aspect ratio such as 16x9; not with resolution"
+}

addedInput schema / properties / color_palette

Added value: +{
+  "description": "A preset palette by name, or explicit hex colours with weights"
+}

changedInput schema / properties / image / description

Previous value: -"Local file path of the source image to reframe"New value: +"Local image file to work on, or a public https URL of one"

removedInput schema / properties / image / minLength
```
Removed value: -1
```
removedInput schema / properties / image / type
```
Removed value: -"string"
```

addedInput schema / properties / image_asset_identifier

Added value: +{
+  "description": "An Ideogram asset (an upload or an earlier result) instead of a local image"
+}

addedInput schema / properties / inline_images

Added value: +{
+  "description": "true: each saved image is also returned as image content (base64; one over 3.75 MB, or past 10 MB in total, by path only), for a client without file access",
+  "type": "boolean"
+}

addedInput schema / properties / model

Added value: +{
+  "description": "The model (default ideogram-3); each takes the fields of its variant below",
+  "enum": [
+    "ideogram-3",
+    "nano-banana-2"
+  ],
+  "type": "string"
+}

changedInput schema / properties / num_images / description

Previous value: -"Number of variations (1-8, default: 1)"New value: +"How many images to make (each is billed)"

removedInput schema / properties / num_images / maximum
```
Removed value: -8
```
removedInput schema / properties / num_images / minimum
```
Removed value: -1
```
removedInput schema / properties / num_images / type
```
Removed value: -"integer"
```

addedInput schema / properties / private

Added value: +{
+  "description": "Keep the result out of Ideogram's public feed; true unless you set false (enterprise accounts are always private)"
+}

changedInput schema / properties / rendering_speed / description

Previous value: -"Speed/quality tradeoff (default: DEFAULT)"New value: +"turbo, default or quality: faster is cheaper"

removedInput schema / properties / rendering_speed / enum

Removed value: -[
-  "FLASH",
-  "TURBO",
-  "DEFAULT",
-  "QUALITY"
-]

removedInput schema / properties / rendering_speed / type
```
Removed value: -"string"
```

changedInput schema / properties / resolution / description

Previous value: -"Target resolution (e.g. 1024x1024, 1536x640). See Ideogram docs for all 69 valid resolutions."New value: +"Exact output size WIDTHxHEIGHT from the model's list; not with aspect_ratio"

removedInput schema / properties / resolution / enum

Removed value: -[
-  "512x1536",
-  "576x1408",
-  "576x1472",
-  "576x1536",
-  "640x1344",
-  "640x1408",
-  "640x1472",
-  "640x1536",
-  "704x1152",
-  "704x1216",
-  "704x1280",
-  "704x1344",
-  "704x1408",
-  "704x1472",
-  "736x1312",
-  "768x1088",
-  "768x1216",
-  "768x1280",
-  "768x1344",
-  "800x1280",
-  "832x960",
-  "832x1024",
-  "832x1088",
-  "832x1152",
-  "832x1216",
-  "832x1248",
-  "864x1152",
-  "896x960",
-  "896x1024",
-  "896x1088",
-  "896x1120",
-  "896x1152",
-  "960x832",
-  "960x896",
-  "960x1024",
-  "960x1088",
-  "1024x832",
-  "1024x896",
-  "1024x960",
-  "1024x1024",
-  "1088x768",
-  "1088x832",
-  "1088x896",
-  "1088x960",
-  "1120x896",
-  "1152x704",
-  "1152x832",
-  "1152x864",
-  "1152x896",
-  "1216x704",
-  "1216x768",
-  "1216x832",
-  "1248x832",
-  "1280x704",
-  "1280x768",
-  "1280x800",
-  "1312x736",
-  "1344x640",
-  "1344x704",
-  "1344x768",
-  "1408x576",
-  "1408x640",
-  "1408x704",
-  "1472x576",
-  "1472x640",
-  "1472x704",
-  "1536x512",
-  "1536x576",
-  "1536x640"
-]

removedInput schema / properties / resolution / type
```
Removed value: -"string"
```

changedInput schema / properties / seed / description

Previous value: -"Reproducibility seed"New value: +"Random seed for a reproducible result"

removedInput schema / properties / seed / maximum
```
Removed value: -2147483647
```
removedInput schema / properties / seed / minimum
```
Removed value: -0
```
removedInput schema / properties / seed / type
```
Removed value: -"integer"
```

addedInput schema / properties / style_codes

Added value: +{
+  "description": "8-character hexadecimal style codes"
+}

addedInput schema / properties / style_preset

Added value: +{
+  "description": "A named style preset; not with style codes or style references"
+}

addedInput schema / properties / style_reference_asset_identifiers

Added value: +{
+  "description": "Ideogram assets (uploads or earlier results) to use as style references"
+}

addedInput schema / properties / style_reference_images

Added value: +{
+  "description": "Local image files (or public https URLs) whose style the result follows"
+}

addedInput schema / properties / wait_s

Added value: +{
+  "description": "Seconds to wait for the result (0-50, default 45). The job is accepted first; if it is still running when the wait ends, the result is its generation_id for ideogram_generation (never resubmitted, never billed twice).",
+  "maximum": 50,
+  "minimum": 0,
+  "type": "integer"
+}

removedInput schema / required

Removed value: -[
-  "image",
-  "resolution"
-]

First observedv1.0.3Sep 25, 2026

TDQS

A4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It usefully discloses that results land in the output directory and that ideogram_quote is non-generating, but says nothing about billing (per-image charges), the async job lifecycle, or what happens on timeout – facts that exist only in the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two compact sentences: the operation and models come first, the output-location and pricing-tool note second. Every clause carries information; nothing is padding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 16-parameter tool with no annotations and no output schema, the description covers the essentials (what it does, where output goes, that ideogram_quote only prices). It leans on the exhaustive 100%-coverage schema for parameter detail, which is acceptable, though it omits the asynchronous/billing behaviour the agent would want.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with rich per-parameter descriptions and enum lists, so the baseline is 3. The description adds only the model names (Ideogram 3.0 / Nano Banana 2) which map to the existing model enum, adding no syntax or constraint detail beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and operation ('Extend an image... by outpainting') plus the two supported models, which cleanly separates it from siblings like ideogram_upscale, ideogram_inpaint, and ideogram_precise_edit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear usage context by pointing at ideogram_quote as the pre-flight pricing step and clarifying that quote generates nothing. It does not state when to prefer this over e.g. reframe-adjacent siblings, so no explicit alternative routing beyond that one mention.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Reframe an image

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools