Batch Banana

View saved version →

---
name: batch-banana
description: Generate images and video, edit images, and run batches with the Batch Banana MCP tools. Use when the user asks to create, edit, upscale, remove a background from, find, or download an image or video, asks for an image in a named look or style, wants many prompts run as a batch, asks what a generation would cost, or asks which Batch Banana workspace is in use.
---

# Batch Banana

Batch Banana runs image generation, video generation, and image edits at third-party model providers and stores every output in the user's workspace library. Every create spends the connected workspace's credits. Quotes, catalog reads, and library reads are free.

## Tools

| Tool | Use |
| --- | --- |
| `list_models` | Image and video models with `tier`, `creditCost`, and `billingUnit` (`output` or `second`). Optional `mediaType`: `image` or `video`. |
| `describe_model` | One model's options, resolution choices, and capabilities. Send every option under `options`, keyed by its `key`, including `options.resolution`. |
| `list_edit_operations` | Edit operations with cost, `requiresPrompt`, reference image range, and `sourceArity`. |
| `describe_edit_operation` | One operation's `params`. |
| `quote_image_generation`, `quote_video_generation`, `quote_image_edit` | Price a request without charging. Returns `creditCost`, `pricingVersion`, `requestHash`. |
| `generate_image`, `generate_video`, `edit_image` | Start a paid job. Returns a job. |
| `get_generation` | Read a job's status and outputs. The only way to learn when a job finishes. |
| `search_styles` | Find a look in the Batch Banana style library by description, list the library by family, or read chosen styles in full. A style's `slug` goes in `generate_image`'s `style`. |
| `search_library` | Find existing work, one result per job, by prompt, kind, model, edit operation, project, or date. Each output has a `fileId`, and each result has the `jobId` that made it. |
| `list_projects` | Project ids for `projectId` on creates and on `search_library`. |
| `get_file` | URLs, size, and dimensions of one file. |
| `import_image` | Turn a public `https` image URL into a file id. |
| `quote_batch`, `create_batch`, `get_batch`, `update_batch` | Batches: price rows, create and run them, follow progress and read results, add rows, retry failed rows. |
| `cancel_batch` | Stop a batch's running run. Only when the user asks. |
| `download_files` | Download links: ZIP files of a batch, one ZIP of up to 50 jobs, or one file. Links work for an hour. |
| `list_workspaces`, `switch_workspace` | The user's workspaces with plan and credits, and moving the connection to another of them. |

## Pick a model

1. Call `list_models` with the media type you need. Match the user's request to `tier` (`fast`, `standard`, `premium`) and cost. Use the `id` field, never the display name.
2. Call `describe_model` before setting anything beyond `prompt`, `aspectRatio`, and `numImages`. Only send options the model lists.
3. If the user names a model, find it in `list_models`. If it is not there, say so and offer the closest match.

Defaults for `generate_image`: `aspectRatio` `1:1`, `numImages` 4 (range 1 to 8). Supported aspect ratios: `21:9`, `16:9`, `4:3`, `3:2`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, limited to what the model supports. Ask for fewer images when the user wants one.

## Several different images

When the user wants several different images, such as four concepts, variations in different styles, or one image per product, make one `generate_image` call with `prompt` as a list of prompts (up to 16), not one call per image. Quote the same list once with `quote_image_generation`. A list makes 1 image per prompt unless `numImages` says otherwise, up to 48 images in all. All prompts in one call share the model, aspect ratio and options. One call keeps every image in one results view; separate calls replace each other's view.

## Batches

A batch is a table of prompts that run togeth

Preview of the first 4,000 characters. Read full instructions →