Claude GitHub Copilot Skill

nano-banana-image

Nano Banana image by Ace Data Cloud. Generate and edit images with Nano Banana, Nano Banana 2.1 or Pro. Use when the user asks for Nano Banana or NanoBanana image generation, reference-image editing or 1K, 2K and 4K output.

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download acedatacloud-skills-skills_nano-banana-image-c3d1703.zip · 9 KB

Install

skills CLI npx skills add https://github.com/AceDataCloud/Skills/tree/main/skills/nano-banana-image
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install acedatacloud-skills@llmmart
Git git clone https://github.com/AceDataCloud/Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole acedatacloud/skills collection as a plugin from our marketplace. Git is the plain clone.

README

Nano Banana by Ace Data Cloud — skills.sh first run

Use Nano Banana through the Ace Data Cloud API from an Agent Skills-compatible coding assistant. This Skill is maintained by Ace Data Cloud and uses your Ace service API key; it does not claim to be published by Nano Banana. Install it independently; the account Skill and an MCP server are optional.

简体中文 · skills.sh installation page · current models and pricing

1. Install this service only

Open the skills.sh page above and check the repository is acedatacloud/skills. In your project terminal:

npx --yes skills@1.7.2 add acedatacloud/skills --skill nano-banana-image -a codex --yes
npx --yes skills@1.7.2 list

This example targets Codex; replace codex with your supported agent, such as claude-code or cursor. For Codex, the installed instructions are .agents/skills/nano-banana-image/SKILL.md. Start a fresh session. Installation does not generate media or set up an API key. This is a Skill, not a model-provider dropdown or a new extension button.

For the released snapshot checked on 2026-10-18, use https://github.com/AceDataCloud/Skills/tree/v2026.1017.279001 in place of acedatacloud/skills. That released snapshot predates these improved instructions; use the default branch after this PR is merged to receive them.

Real skills.sh installation control

Actual account-Skill page captured on 2026-10-17, showing the same installation control. Use this service's slug above; the screenshot is not a nano-banana-image installation or generation result. Image sources and limits.

2. Register, sign in and get the correct API key

  1. Open Ace Data Cloud → Applications; register and sign in if needed.
  2. Open General application. If absent, choose Initialize General Application. Check Nano Banana access, current balance and price before submitting anything.
  3. Copy the key on the application card, or open Manage Keys → Create to create a separate key such as skills.sh Nano Banana. Set expiry and API/usage limits as needed. If Allowed APIs is enabled, include /nano-banana/images and /nano-banana/tasks. Other actions in SKILL.md may need extra routes.
  4. Copy only the key value. Do not include Bearer or screenshot redaction characters. A platform-... management token is not the service key.

Copy API key or open Manage Keys

Create an optional dedicated key

These are existing, redacted Ace console screenshots from the Suno Dify guide, checked on 2026-10-18. They illustrate the shared key controls, not a Nano Banana run in skills.sh. The example name “Dify tutorial” is illustrative; use your own name. Menu labels may change.

3. Put the key in the assistant's execution environment

skills.sh does not store credentials. For a terminal-launched coding assistant, export the key in that terminal before starting the assistant, then start a new session:

export ACEDATACLOUD_API_TOKEN="your_api_key_here"

For an already running IDE, restart it from the configured environment or use that IDE's documented secret/environment settings. A Skill install does not load .env automatically. Never paste the key into a prompt, commit it, or print it in logs. OpenClaw has its own Gateway setup in SKILL.md; it is not required for skills.sh installation.

4. Submit once and inspect the result

Read SKILL.md and its exact request shape first. Ask your assistant to use Nano Banana by Ace Data Cloud, inspect the current price, and prepare a single image request using nano-banana-2.1. Approve the intended cost before it submits /nano-banana/images. Installation and a prepared request do not prove that generation ran.

Run the existing Quick Start only after the key and intended cost are correct. For an asynchronous response, save its task ID and query that same ID at /nano-banana/tasks. Do not resubmit generation to check progress. Read the image URL from the completed result. Keep this endpoint's schema separate from the OpenAI-compatible image schema.

Example request copied from this Skill's current Quick Start. Billable: run only after confirming the service, price and intended request. It has not been executed for this guide:

curl -X POST https://api.acedata.cloud/nano-banana/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'

If the response returns a task ID, query that ID with the following command; replace YOUR_TASK_ID with the existing ID.

curl -X POST https://api.acedata.cloud/nano-banana/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"YOUR_TASK_ID"}'

The expected output is an actual returned audio/video/image URL after terminal success, not a URL copied from this guide. Keep the same task ID while pending.

Use the exact task response fields and terminal states in SKILL.md. A URL in this guide would be illustrative; no media generation was performed for this tutorial. Check the request/task history for one intended charge; a completed media link alone does not prove the final bill.

Troubleshooting

Symptom What to check
401 Full service key, no Bearer inside its value, available to the actual assistant process.
403 Service access, expiry and Allowed APIs; read the error because moderation can also return 403.
400 Exact model ID and request shape in SKILL.md; do not silently substitute a model.
429 Wait and reduce concurrency; do not automatically retry a paid submit.
Pending / timeout / 5xx Read the same task or request history before considering a new submit.
Media URL unavailable Confirm terminal success and use the actual returned URL; share only task/trace ID with support.

Support: dev@acedata.cloud. Source: AceDataCloud/Skills. skills.sh installation counters are not unique users or revenue. Source links use the four supported UTM fields for this skills.sh guide; they do not prove a registration or payment.

Skill manifest

Nano Banana by Ace Data Cloud

Generate and edit AI images through AceDataCloud's NanoBanana (Gemini-based) API.

Install and connect from skills.sh

This integration is maintained by Ace Data Cloud; it is not an official Nano Banana publisher listing. Install only this Skill with npx skills add acedatacloud/skills --skill nano-banana-image --yes, or use the public skills.sh page. Keep the slug nano-banana-image when selecting it.

Read the illustrated first-run guide (简体中文) for registration, Applications → General application, API key access and price checks, and the environment variable location for your coding agent. For skills.sh installations, use this guide; any ClawHub-specific setup applies only to OpenClaw. The shared references linked here are online because focused installs do not include sibling _shared/ folders.

ClawHub / OpenClaw setup

  1. Install the official Skill with clawhub install @acedatacloud/nano-banana. Check that the ClawHub publisher is @acedatacloud.
  2. Sign in at AceDataCloud → Applications, open General application, and check Nano Banana access, balance, and current pricing. Copy its API key, or select Manage Keys → Create for a separate key. Copy the key value without Bearer ; a platform-... management token is not a service API key.
  3. If you enable Allowed APIs restrictions, include /nano-banana/images and /nano-banana/tasks. Advanced workflows below may call additional routes.
  4. On the OpenClaw Gateway host, put ACEDATACLOUD_API_TOKEN=your_api_key_here in ~/.openclaw/.env, then restart the Gateway and start a new session. For a direct terminal test, run export ACEDATACLOUD_API_TOKEN="your_api_key_here" in that shell. Never put the key in a prompt or commit an .env file.
  5. Run the Quick Start below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.

Illustrated key setup, first run, and troubleshooting · Token details

Quick Start

curl -X POST https://api.acedata.cloud/nano-banana/images \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'

Async: See async task polling. Poll via POST /nano-banana/tasks with {"id": "..."}.

Models

Model Best For
nano-banana Standard image generation (default)
nano-banana-2-lite Fast, lightweight second-generation model
nano-banana-2 Improved quality, second generation
nano-banana-2.1 Latest efficient model; 1K, 2K, and 4K generation and editing
nano-banana-pro Highest quality, most detailed output
nano-banana:official Official channel variant of nano-banana
nano-banana-2-lite:official Official channel variant of nano-banana-2-lite
nano-banana-2:official Official channel variant of nano-banana-2
nano-banana-pro:official Official channel variant of nano-banana-pro

Workflows

1. Text-to-Image

POST /nano-banana/images
{
  "action": "generate",
  "prompt": "a photorealistic macro shot of morning dew on a spider web",
  "model": "nano-banana-2.1",
  "aspect_ratio": "16:9",
  "resolution": "2K"
}

2. Image Editing

Edit existing images using natural language instructions — no mask needed. Pass source images via image_urls.

POST /nano-banana/images
{
  "action": "edit",
  "prompt": "change the background to a starry night sky",
  "image_urls": ["https://example.com/photo.jpg"],
  "model": "nano-banana-2.1",
  "resolution": "2K"
}

Parameters

Parameter Values Description
action "generate", "edit" Operation mode
model "nano-banana", "nano-banana-2-lite", "nano-banana-2", "nano-banana-2.1", "nano-banana-pro", "nano-banana:official", "nano-banana-2-lite:official", "nano-banana-2:official", "nano-banana-pro:official" Model to use; 2.1 has no :official variant
prompt string Image description or editing instruction
image_urls array of strings Source image URLs (required for edit action)
aspect_ratio "1:1", "3:2", "2:3", "16:9", "9:16", "4:3", "3:4" Output aspect ratio
resolution "1K", "2K", "4K" Default 1K; nano-banana and nano-banana-2-lite support only 1K; 2, 2.1, and Pro support all three resolutions
callback_url string Async callback URL; returns a task ID immediately

To use 2.1, explicitly set model:"nano-banana-2.1"; omitting model still selects nano-banana. For nonblocking requests, set async:true, retain task_id, and poll /nano-banana/tasks to terminal success before returning an image. No nano-banana-2.1:official variant is published.

The same 2.1 model is also accepted by POST /openai/images/generations (public alias /v1/images/generations) and POST /openai/images/edits (public alias /v1/images/edits). Those use their own OpenAI-compatible schemas (image for JSON editing, not image_urls; size rather than this endpoint's resolution/aspect_ratio). Check that endpoint's current schema before reusing a request; do not assume identical response fields. Prices depend on the current service/package; consult live pricing rather than hard-coding a per-call USD amount.

Gotchas

  • Editing does NOT require a mask — just describe the change in natural language
  • Editing uses the same /nano-banana/images endpoint with action: "edit" and image_urls array (not a separate /edit path)
  • nano-banana-2.1 supports 1K, 2K, and 4K; nano-banana-pro offers the highest quality
  • :official variants (e.g., nano-banana:official) route through the official channel
  • Task polling uses id (not task_id) in the /nano-banana/tasks request body
  • Aspect ratio uses colon notation (e.g., "16:9") not pixel dimensions
  • The Gemini-based model excels at understanding complex, conversational editing instructions

MCP: pip install mcp-nano-banana | Hosted: https://nanobanana.mcp.acedata.cloud/mcp | See all MCP servers

Files (skills)
  • README.md 7.1 KB
    # Nano Banana by Ace Data Cloud — skills.sh first run
    
    Use Nano Banana through the **Ace Data Cloud** API from an Agent Skills-compatible coding assistant. This Skill is maintained by Ace Data Cloud and uses your Ace service API key; it does not claim to be published by Nano Banana. Install it independently; the account Skill and an MCP server are optional.
    
    [简体中文](readme.zh-CN.md) · [skills.sh installation page](https://skills.sh/acedatacloud/skills/nano-banana-image) · [current models and pricing](https://platform.acedata.cloud/models?utm_source=skills_sh&utm_medium=referral&utm_campaign=evergreen&utm_content=nano_banana_image_pricing)
    
    ## 1. Install this service only
    
    Open the skills.sh page above and check the repository is **acedatacloud/skills**. In your project terminal:
    
    ```bash
    npx --yes skills@1.7.2 add acedatacloud/skills --skill nano-banana-image -a codex --yes
    npx --yes skills@1.7.2 list
    ```
    
    This example targets Codex; replace `codex` with your supported agent, such as `claude-code` or `cursor`. For Codex, the installed instructions are `.agents/skills/nano-banana-image/SKILL.md`. Start a fresh session. Installation does not generate media or set up an API key. This is a Skill, not a model-provider dropdown or a new extension button.
    
    For the released snapshot checked on 2026-10-18, use `https://github.com/AceDataCloud/Skills/tree/v2026.1017.279001` in place of `acedatacloud/skills`. That released snapshot predates these improved instructions; use the default branch after this PR is merged to receive them.
    
    ![Real skills.sh installation control](https://raw.githubusercontent.com/AceDataCloud/Skills/0901d63b7f7d216318463b1c33976838a084da3b/docs/skills-sh/installation-page-20261017.jpg)
    
    Actual account-Skill page captured on 2026-10-17, showing the same installation control. Use this service's slug above; the screenshot is not a nano-banana-image installation or generation result. [Image sources and limits](https://github.com/AceDataCloud/Skills/blob/0901d63b7f7d216318463b1c33976838a084da3b/docs/skills-sh/image-sources.json).
    
    ## 2. Register, sign in and get the correct API key
    
    1. Open [Ace Data Cloud → Applications](https://platform.acedata.cloud/console/applications?utm_source=skills_sh&utm_medium=referral&utm_campaign=evergreen&utm_content=nano_banana_image_api_key); register and sign in if needed.
    2. Open **General application**. If absent, choose **Initialize General Application**. Check **Nano Banana** access, current balance and price before submitting anything.
    3. Copy the key on the application card, or open **Manage Keys → Create** to create a separate key such as `skills.sh Nano Banana`. Set expiry and API/usage limits as needed. If **Allowed APIs** is enabled, include `/nano-banana/images` and `/nano-banana/tasks`. Other actions in SKILL.md may need extra routes.
    4. Copy only the key value. Do not include `Bearer ` or screenshot redaction characters. A `platform-...` management token is not the service key.
    
    ![Copy API key or open Manage Keys](https://raw.githubusercontent.com/AceDataCloud/SunoDify/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial/get-api-key-en.png)
    
    ![Create an optional dedicated key](https://raw.githubusercontent.com/AceDataCloud/SunoDify/8d3d03570e73324220f111f7fe343da0792a8071/_assets/tutorial/create-api-key-en.png)
    
    These are existing, redacted **Ace console** screenshots from the [Suno Dify guide](https://github.com/AceDataCloud/SunoDify/blob/8d3d03570e73324220f111f7fe343da0792a8071/README.md), checked on 2026-10-18. They illustrate the shared key controls, not a Nano Banana run in skills.sh. The example name “Dify tutorial” is illustrative; use your own name. Menu labels may change.
    
    ## 3. Put the key in the assistant's execution environment
    
    skills.sh does not store credentials. For a terminal-launched coding assistant, export the key in that terminal **before starting the assistant**, then start a new session:
    
    ```bash
    export ACEDATACLOUD_API_TOKEN="your_api_key_here"
    ```
    
    For an already running IDE, restart it from the configured environment or use that IDE's documented secret/environment settings. A Skill install does not load `.env` automatically. Never paste the key into a prompt, commit it, or print it in logs. OpenClaw has its own Gateway setup in SKILL.md; it is not required for skills.sh installation.
    
    ## 4. Submit once and inspect the result
    
    Read [SKILL.md](SKILL.md) and its exact request shape first. Ask your assistant to use **Nano Banana by Ace Data Cloud**, inspect the current price, and prepare a single image request using `nano-banana-2.1`. Approve the intended cost before it submits `/nano-banana/images`. Installation and a prepared request do not prove that generation ran.
    
    Run the existing Quick Start only after the key and intended cost are correct. For an asynchronous response, save its task ID and query **that same ID** at `/nano-banana/tasks`. Do not resubmit generation to check progress. Read the image URL from the completed result. Keep this endpoint's schema separate from the OpenAI-compatible image schema.
    
    Example request copied from this Skill's current Quick Start. **Billable: run only after confirming the service, price and intended request.** It has not been executed for this guide:
    
    ```bash
    curl -X POST https://api.acedata.cloud/nano-banana/images \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"action": "generate", "prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'
    ```
    
    If the response returns a task ID, query that ID with the following command; replace `YOUR_TASK_ID` with the existing ID.
    
    ```bash
    curl -X POST https://api.acedata.cloud/nano-banana/tasks \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"id":"YOUR_TASK_ID"}'
    ```
    
    The expected output is an actual returned audio/video/image URL after terminal success, not a URL copied from this guide. Keep the same task ID while pending.
    
    Use the exact task response fields and terminal states in SKILL.md. A URL in this guide would be illustrative; no media generation was performed for this tutorial. Check the request/task history for one intended charge; a completed media link alone does not prove the final bill.
    
    ## Troubleshooting
    
    | Symptom | What to check |
    |---|---|
    | 401 | Full service key, no `Bearer ` inside its value, available to the actual assistant process. |
    | 403 | Service access, expiry and Allowed APIs; read the error because moderation can also return 403. |
    | 400 | Exact model ID and request shape in SKILL.md; do not silently substitute a model. |
    | 429 | Wait and reduce concurrency; do not automatically retry a paid submit. |
    | Pending / timeout / 5xx | Read the same task or request history before considering a new submit. |
    | Media URL unavailable | Confirm terminal success and use the actual returned URL; share only task/trace ID with support. |
    
    Support: [dev@acedata.cloud](mailto:dev@acedata.cloud). Source: [AceDataCloud/Skills](https://github.com/AceDataCloud/Skills). skills.sh installation counters are not unique users or revenue. Source links use the four supported UTM fields for this skills.sh guide; they do not prove a registration or payment.
    
  • readme.zh-CN.md 5.7 KB
    Loading…
  • SKILL.md 7.1 KB
    ---
    name: nano-banana-image
    description: Nano Banana image by Ace Data Cloud. Generate and edit images with Nano Banana, Nano Banana 2.1 or Pro. Use when the user asks for Nano Banana or NanoBanana image generation, reference-image editing or 1K, 2K and 4K output.
    license: Apache-2.0
    metadata:
      author: acedatacloud
      version: "1.0"
    compatibility: Requires ACEDATACLOUD_API_TOKEN in the agent process environment and HTTPS access to api.acedata.cloud. See README.md for installation and key setup.
    ---
    
    # Nano Banana by Ace Data Cloud
    
    Generate and edit AI images through AceDataCloud's NanoBanana (Gemini-based) API.
    
    ## Install and connect from skills.sh
    
    This integration is maintained by **Ace Data Cloud**; it is not an official Nano Banana publisher listing. Install only this Skill with `npx skills add acedatacloud/skills --skill nano-banana-image --yes`, or use the [public skills.sh page](https://skills.sh/acedatacloud/skills/nano-banana-image). Keep the slug `nano-banana-image` when selecting it.
    
    Read the [illustrated first-run guide](README.md) ([简体中文](readme.zh-CN.md)) for registration, **Applications → General application**, API key access and price checks, and the environment variable location for your coding agent. For skills.sh installations, use this guide; any ClawHub-specific setup applies only to OpenClaw. The shared references linked here are online because focused installs do not include sibling `_shared/` folders.
    
    ## ClawHub / OpenClaw setup
    
    1. Install the official Skill with `clawhub install @acedatacloud/nano-banana`. Check that the ClawHub publisher is **@acedatacloud**.
    2. Sign in at [AceDataCloud → Applications](https://platform.acedata.cloud/console/applications), open **General application**, and check Nano Banana access, balance, and current pricing. Copy its API key, or select **Manage Keys → Create** for a separate key. Copy the key value without `Bearer `; a `platform-...` management token is not a service API key.
    3. If you enable **Allowed APIs** restrictions, include `/nano-banana/images` and `/nano-banana/tasks`. Advanced workflows below may call additional routes.
    4. On the OpenClaw Gateway host, put `ACEDATACLOUD_API_TOKEN=your_api_key_here` in `~/.openclaw/.env`, then restart the Gateway and start a new session. For a direct terminal test, run `export ACEDATACLOUD_API_TOKEN="your_api_key_here"` in that shell. Never put the key in a prompt or commit an `.env` file.
    5. Run the **Quick Start** below. If this workflow returns a task ID, query that same task until it finishes; do not submit the same billable request again just to check progress.
    
    [Illustrated key setup, first run, and troubleshooting](https://github.com/AceDataCloud/Skills#first-run-with-clawhub-and-openclaw) · [Token details](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/authentication.md)
    
    ## Quick Start
    
    ```bash
    curl -X POST https://api.acedata.cloud/nano-banana/images \
      -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"action": "generate", "prompt": "a watercolor painting of a French countryside village", "model": "nano-banana"}'
    ```
    
    > **Async:** See [async task polling](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/async-tasks.md). Poll via `POST /nano-banana/tasks` with `{"id": "..."}`.
    ## Models
    
    | Model | Best For |
    |-------|----------|
    | `nano-banana` | Standard image generation (default) |
    | `nano-banana-2-lite` | Fast, lightweight second-generation model |
    | `nano-banana-2` | Improved quality, second generation |
    | `nano-banana-2.1` | Latest efficient model; 1K, 2K, and 4K generation and editing |
    | `nano-banana-pro` | Highest quality, most detailed output |
    | `nano-banana:official` | Official channel variant of `nano-banana` |
    | `nano-banana-2-lite:official` | Official channel variant of `nano-banana-2-lite` |
    | `nano-banana-2:official` | Official channel variant of `nano-banana-2` |
    | `nano-banana-pro:official` | Official channel variant of `nano-banana-pro` |
    
    ## Workflows
    
    ### 1. Text-to-Image
    
    ```json
    POST /nano-banana/images
    {
      "action": "generate",
      "prompt": "a photorealistic macro shot of morning dew on a spider web",
      "model": "nano-banana-2.1",
      "aspect_ratio": "16:9",
      "resolution": "2K"
    }
    ```
    
    ### 2. Image Editing
    
    Edit existing images using natural language instructions — no mask needed. Pass source images via `image_urls`.
    
    ```json
    POST /nano-banana/images
    {
      "action": "edit",
      "prompt": "change the background to a starry night sky",
      "image_urls": ["https://example.com/photo.jpg"],
      "model": "nano-banana-2.1",
      "resolution": "2K"
    }
    ```
    
    ## Parameters
    
    | Parameter | Values | Description |
    |-----------|--------|-------------|
    | `action` | `"generate"`, `"edit"` | Operation mode |
    | `model` | `"nano-banana"`, `"nano-banana-2-lite"`, `"nano-banana-2"`, `"nano-banana-2.1"`, `"nano-banana-pro"`, `"nano-banana:official"`, `"nano-banana-2-lite:official"`, `"nano-banana-2:official"`, `"nano-banana-pro:official"` | Model to use; 2.1 has no `:official` variant |
    | `prompt` | string | Image description or editing instruction |
    | `image_urls` | array of strings | Source image URLs (required for edit action) |
    | `aspect_ratio` | `"1:1"`, `"3:2"`, `"2:3"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"` | Output aspect ratio |
    | `resolution` | `"1K"`, `"2K"`, `"4K"` | Default 1K; `nano-banana` and `nano-banana-2-lite` support only 1K; 2, 2.1, and Pro support all three resolutions |
    | `callback_url` | string | Async callback URL; returns a task ID immediately |
    
    To use 2.1, explicitly set `model:"nano-banana-2.1"`; omitting `model` still selects `nano-banana`. For nonblocking requests, set `async:true`, retain `task_id`, and poll `/nano-banana/tasks` to terminal success before returning an image. No `nano-banana-2.1:official` variant is published.
    
    The same 2.1 model is also accepted by `POST /openai/images/generations` (public alias `/v1/images/generations`) and `POST /openai/images/edits` (public alias `/v1/images/edits`). Those use their own OpenAI-compatible schemas (`image` for JSON editing, not `image_urls`; `size` rather than this endpoint's `resolution`/`aspect_ratio`). Check that endpoint's current schema before reusing a request; do not assume identical response fields. Prices depend on the current service/package; consult live pricing rather than hard-coding a per-call USD amount.
    
    ## Gotchas
    
    - Editing does **NOT** require a mask — just describe the change in natural language
    - Editing uses the same `/nano-banana/images` endpoint with `action: "edit"` and `image_urls` array (not a separate `/edit` path)
    - `nano-banana-2.1` supports 1K, 2K, and 4K; `nano-banana-pro` offers the highest quality
    - `:official` variants (e.g., `nano-banana:official`) route through the official channel
    - Task polling uses `id` (not `task_id`) in the `/nano-banana/tasks` request body
    - Aspect ratio uses colon notation (e.g., `"16:9"`) not pixel dimensions
    - The Gemini-based model excels at understanding complex, conversational editing instructions
    
    > **MCP:** `pip install mcp-nano-banana` | Hosted: `https://nanobanana.mcp.acedata.cloud/mcp` | See [all MCP servers](https://github.com/AceDataCloud/Skills/blob/main/skills/_shared/mcp-servers.md)
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.