switch

Generate Image

generate_image

Generate Switch images with one of six models: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2.1 (Google's newest, up to 14 reference pictures), Nano Banana 2 or Switch Vintage. Nothing older is offered or accepted. When model is omitted it auto-routes by subject: GPT Image 2.5 by default and for typography, screens and storyboards, Switch Pro for swimwear/beach, Switch Ultra for sexier content or face-fidelity work. The Nano Bananas and Switch Vintage are only used when named. Switch Vintage is a film look that works from a character taught beforehand, not from reference pictures. Counts <= 8 render inline in chat; counts > 8 queue to your Switch Studio with progress polling. All images persist to your Studio library and folder. Optional style (e.g. "wellness/warm_amber_tropical", "movie_scene/neon_noir_action") applies a curated photographic stack from the apply_* skill tools.

Input Schema

TableJSON Schema

Name	Required	Description
`count`	No	How many images to generate. Default 4. <= 8 returns inline, > 8 queues to Studio. Beta limit: max 50 per request — larger asks are capped at 50 and the response says so.
`model`	No	Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2.1, Nano Banana 2 or Switch Vintage. Nothing else is accepted. Switch Vintage works from a character taught beforehand: pass no reference_image_urls or face_reference_ids with it. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description).
`style`	No	Optional curated style stack from the apply_* skill tools. Format "<skill>/<style_key>", e.g. "wellness/warm_amber_tropical" or "high_fashion_editorial/leibovitz_painterly".
`subject`	Yes	Plain-English description of what to generate. E.g. "a woman walking through a hotel lobby" or "morning coffee on the balcony, model wearing a robe". Name the creator's staged Studio references as @Image1, @Image2 (their image strip, see get_my_active_references) and they attach automatically; nothing from the strip attaches unless named.
`folder_name`	No	Optional Switch Studio folder name. Auto-created if missing. Defaults to the chat-derived title.
`aspect_ratio`	No	Image aspect ratio. Default 9:16 (vertical, social-friendly). Switch Vintage takes 9:16, 16:9, 4:3, 3:4, 1:1, 2:3 and 3:2 as is; any other ratio is mapped to the nearest one it offers.
`real_photo_look`	No	Optional. Adds the casual real-photo texture (film grain, amateur iPhone feel). OFF by default — only set true when the user asks for the realistic, unpolished look.
`face_reference_ids`	No	Face reference asset ids from upload_reference_asset (frame_type "face"). The ONLY way to use a face/likeness reference. Each id is verified server-side (your own untouched original + identity verification) before anything generates or is charged; a URL or generic upload here is rejected.
`reference_image_urls`	No	Optional public image URLs used as GENERIC references (products, scenery, outfits, style). These are never treated as face references — for a person's face/likeness use face_reference_ids.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`asset`	No
`images`	No
`_widget`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 6, 2026

changedInput schema / properties / model / description

Previous value: -"Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2 or Switch Vintage. Nothing else is accepted. Switch Vintage works from a character taught beforehand: pass no reference_image_urls or face_reference_ids with it. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description)."New value: +"Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2.1, Nano Banana 2 or Switch Vintage. Nothing else is accepted. Switch Vintage works from a character taught beforehand: pass no reference_image_urls or face_reference_ids with it. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description)."

changedInput schema / properties / model / enum

Previous value: -[
-  "GPT Image 2.5",
-  "Switch Pro",
-  "Switch Ultra",
-  "Nano Banana 2",
-  "Switch Vintage"
-]New value: +[
+  "GPT Image 2.5",
+  "Switch Pro",
+  "Switch Ultra",
+  "Nano Banana 2.1",
+  "Nano Banana 2",
+  "Switch Vintage"
+]

Changed1 schema field changedSep 29, 2026

changedInput schema / properties / subject / description

Previous value: -"Plain-English description of what to generate. E.g. \"a woman walking through a hotel lobby\" or \"morning coffee on the balcony, model wearing a robe\"."New value: +"Plain-English description of what to generate. E.g. \"a woman walking through a hotel lobby\" or \"morning coffee on the balcony, model wearing a robe\". Name the creator's staged Studio references as @Image1, @Image2 (their image strip, see get_my_active_references) and they attach automatically; nothing from the strip attaches unless named."

Changed1 schema field changedSep 27, 2026

changedInput schema / properties / model / description

Previous value: -"Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2 or Switch Vintage. Nothing else is accepted. Switch Vintage is prompt only: pass no reference_image_urls or face_reference_ids with it. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description)."New value: +"Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2 or Switch Vintage. Nothing else is accepted. Switch Vintage works from a character taught beforehand: pass no reference_image_urls or face_reference_ids with it. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description)."

Changed3 schema fields changedSep 23, 2026

changedInput schema / properties / aspect_ratio / description

Previous value: -"Image aspect ratio. Default 9:16 (vertical, social-friendly)."New value: +"Image aspect ratio. Default 9:16 (vertical, social-friendly). Switch Vintage takes 9:16, 16:9, 4:3, 3:4, 1:1, 2:3 and 3:2 as is; any other ratio is mapped to the nearest one it offers."

changedInput schema / properties / model / description

Previous value: -"Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra or Nano Banana 2. Nothing else is accepted. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description)."New value: +"Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra, Nano Banana 2 or Switch Vintage. Nothing else is accepted. Switch Vintage is prompt only: pass no reference_image_urls or face_reference_ids with it. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description)."

changedInput schema / properties / model / enum

Previous value: -[
-  "GPT Image 2.5",
-  "Switch Pro",
-  "Switch Ultra",
-  "Nano Banana 2"
-]New value: +[
+  "GPT Image 2.5",
+  "Switch Pro",
+  "Switch Ultra",
+  "Nano Banana 2",
+  "Switch Vintage"
+]

Changed2 schema fields changedSep 23, 2026

changedInput schema / properties / model / description

Previous value: -"Optional explicit model. If omitted, auto-routed based on subject content (see tool description)."New value: +"Optional explicit model: GPT Image 2.5, Switch Pro, Switch Ultra or Nano Banana 2. Nothing else is accepted. If omitted, auto-routed to GPT Image 2.5, Switch Pro or Switch Ultra by subject (see tool description)."

changedInput schema / properties / model / enum

Previous value: -[
-  "Nano Banana 2",
-  "Nano Banana Pro",
-  "Switch Model",
-  "Switch Pro",
-  "Switch Ultra",
-  "GPT Image 2",
-  "GPT Image 2.5",
-  "GPT Image 2.5 Flare",
-  "WAN 2.7"
-]New value: +[
+  "GPT Image 2.5",
+  "Switch Pro",
+  "Switch Ultra",
+  "Nano Banana 2"
+]

Changed1 schema field changedSep 9, 2026

changedInput schema / properties / model / enum

Previous value: -[
-  "Nano Banana 2",
-  "Nano Banana Pro",
-  "Switch Model",
-  "Switch Pro",
-  "Switch Ultra",
-  "GPT Image 2",
-  "WAN 2.7"
-]New value: +[
+  "Nano Banana 2",
+  "Nano Banana Pro",
+  "Switch Model",
+  "Switch Pro",
+  "Switch Ultra",
+  "GPT Image 2",
+  "GPT Image 2.5",
+  "GPT Image 2.5 Flare",
+  "WAN 2.7"
+]

Changed2 schema fields changedJul 15, 2026

addedInput schema / properties / face_reference_ids

Added value: +{
+  "description": "Face reference asset ids from upload_reference_asset (frame_type \"face\"). The ONLY way to use a face/likeness reference. Each id is verified server-side (your own untouched original + identity verification) before anything generates or is charged; a URL or generic upload here is rejected.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedInput schema / properties / reference_image_urls / description

Previous value: -"Optional public image URLs to use as face/body/scene references."New value: +"Optional public image URLs used as GENERIC references (products, scenery, outfits, style). These are never treated as face references — for a person's face/likeness use face_reference_ids."

Changed1 schema field changedJul 5, 2026

addedInput schema / properties / real_photo_look

Added value: +{
+  "description": "Optional. Adds the casual real-photo texture (film grain, amateur iPhone feel). OFF by default — only set true when the user asks for the realistic, unpolished look.",
+  "type": "boolean"
+}

Changed1 schema field changedJun 13, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "_widget": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "asset": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "images": {
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Changed1 schema field changedJun 11, 2026

changedInput schema / properties / count / description

Previous value: -"How many images to generate. Default 4. <= 8 returns inline, > 8 queues to Studio."New value: +"How many images to generate. Default 4. <= 8 returns inline, > 8 queues to Studio. Beta limit: max 50 per request — larger asks are capped at 50 and the response says so."

Changed1 schema field changedJun 10, 2026

changedInput schema / properties / model / enum

Previous value: -[
-  "Nano Banana 2",
-  "Nano Banana Pro",
-  "Switch Model",
-  "Switch Pro",
-  "Switch Ultra",
-  "GPT Image 2",
-  "FLUX 2 Pro",
-  "WAN 2.7"
-]New value: +[
+  "Nano Banana 2",
+  "Nano Banana Pro",
+  "Switch Model",
+  "Switch Pro",
+  "Switch Ultra",
+  "GPT Image 2",
+  "WAN 2.7"
+]

First observedJun 5, 2026

TDQS

Score is being calculated.

All switch tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?