mcpField
N
nano-banana-image

nano-banana-image

github.com/acedatacloudクリエイティブ・メディア17222 回インストール今日更新
リポジトリ

nano-banana-image について

nano-banana-imageは、Geminiベースのモデルを使うAceDataCloudのNanoBanana APIで画像を生成、編集するスキルです。テキストからの生成、自然言語での編集、モデルや出力設定の選択が必要なエージェント向けです。

主な機能

  1. 01プロンプトから画像を生成
  2. 02自然言語の指示で画像を編集
  3. 03NanoBananaモデルの選択
  4. 04アスペクト比と解像度の設定
  5. 05非同期タスクのポーリング

活用シーン

  1. 01説明文から画像を作成
  2. 02既存画像の背景を変更
  3. 032Kまたは4K出力を指定
  4. 04非同期生成の状態を確認

MCP 対応

mcp-nano-bananaパッケージとホスト型MCPエンドポイントを案内します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/acedatacloud/skills --skill nano-banana-image

インストール後、Claude Code で/nano-banana-imageを入力して読み込まれたか確認します。

同梱ファイルREADME.mdreadme.zh-CN.md

詳細

Ace Data Cloud の Nano Banana

AceDataCloud の NanoBanana（Gemini ベース）API を使って、AI 画像を生成・編集します。

skills.sh からインストールして接続する

この連携は Ace Data Cloud が管理しており、Nano Banana の公式パブリッシャーによる掲載ではありません。npx skills add acedatacloud/skills --skill nano-banana-image --yes を使ってこの Skill のみをインストールするか、skills.sh の公開ページを利用してください。選択時にはスラッグ nano-banana-image をそのまま使用してください。

登録、Applications → General application、API キーへのアクセスと料金の確認、コーディングエージェント用の環境変数の設定場所については、図解付きの初回起動ガイド（日本語）をお読みください。skills.sh からインストールする場合は、このガイドを使用してください。ClawHub 固有のセットアップは OpenClaw のみに適用されます。ここでリンクされている共通リファレンスは、個別インストールには兄弟の _shared/ フォルダーが含まれないため、オンラインで公開されています。

ClawHub / OpenClaw のセットアップ

  1. clawhub install @acedatacloud/nano-banana で公式 Skill をインストールします。ClawHub のパブリッシャーが @acedatacloud であることを確認してください。
  2. AceDataCloud → Applications にサインインし、General application を開いて、Nano Banana へのアクセス、残高、現在の料金を確認します。API キーをコピーするか、Manage Keys → Create を選択して別のキーを作成します。Bearer を含めずにキーの値をコピーしてください。platform-... 形式の管理トークンはサービス API キーではありません。
  3. Allowed APIs の制限を有効にする場合は、/nano-banana/images と /nano-banana/tasks を含めてください。以下の高度なワークフローでは、追加のルートを呼び出す場合があります。
  4. OpenClaw Gateway ホストで、ACEDATACLOUD_API_TOKEN=your_api_key_here を ~/.openclaw/.env に追加し、Gateway を再起動して新しいセッションを開始します。ターミナルから直接テストする場合は、そのシェルで export ACEDATACLOUD_API_TOKEN="your_api_key_here" を実行します。キーをプロンプトに記載したり、.env ファイルをコミットしたりしないでください。
  5. 以下の クイックスタート を実行します。このワークフローがタスク ID を返した場合は、完了するまで同じタスクを照会してください。進捗を確認するためだけに、同じ課金対象のリクエストを再送信しないでください。

キーの設定、初回起動、トラブルシューティングの図解 · トークンの詳細

クイックスタート

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"}'

非同期: 非同期タスクのポーリングを参照してください。POST /nano-banana/tasks に {"id": "..."} を指定してポーリングします。

モデル

モデル最適な用途
nano-banana標準的な画像生成（デフォルト）
nano-banana-2-lite高速で軽量な第 2 世代モデル
nano-banana-2品質を向上させた第 2 世代モデル
nano-banana-2.1最新の効率的なモデル。1K、2K、4K の生成と編集に対応
nano-banana-pro最高品質で、最も詳細な出力
nano-banana:officialnano-banana の公式チャネル版
nano-banana-2-lite:officialnano-banana-2-lite の公式チャネル版
nano-banana-2:officialnano-banana-2 の公式チャネル版
nano-banana-pro:officialnano-banana-pro の公式チャネル版

ワークフロー

1. テキストから画像を生成
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_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"
}

パラメーター

パラメーター値説明
action"generate", "edit"操作モード
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"使用するモデル。2.1 には :official バリアントがありません
promptstring画像の説明または編集指示
image_urlsarray of stringsソース画像の URL（編集アクションでは必須）
aspect_ratio"1:1", "3:2", "2:3", "16:9", "9:16", "4:3", "3:4"出力のアスペクト比
resolution"1K", "2K", "4K"デフォルトは 1K。nano-banana と nano-banana-2-lite は 1K のみ対応。2、2.1、Pro は 3 つすべての解像度に対応
callback_urlstring非同期コールバック URL。タスク ID をすぐに返します

2.1 を使用するには、model:"nano-banana-2.1" を明示的に設定してください。model を省略すると、引き続き nano-banana が選択されます。ブロッキングしないリクエストを行うには、async:true を設定して task_id を保持し、画像を返す前に /nano-banana/tasks をポーリングしてタスクが最終的に成功するまで確認してください。nano-banana-2.1:official バリアントは公開されていません。

同じ 2.1 モデルは、POST /openai/images/generations（公開エイリアス /v1/images/generations）および POST /openai/images/edits（公開エイリアス /v1/images/edits）でも使用できます。これらのエンドポイントでは、それぞれ独自の OpenAI 互換スキーマが使われます（JSON 編集では image_urls ではなく image、またこのエンドポイントの resolution／aspect_ratio ではなく size を使用）。リクエストを再利用する前に、そのエンドポイントの最新スキーマを確認してください。レスポンスフィールドが同じだと想定しないでください。料金は現在のサービス／パッケージによって異なります。1 回あたりの USD 金額をハードコードせず、最新の料金を確認してください。

注意点

  • 編集にマスクは不要です。変更内容を自然言語で説明するだけでかまいません
  • 編集では、別個の /edit パスではなく、action: "edit" と image_urls 配列を指定して、同じ /nano-banana/images エンドポイントを使用します
  • nano-banana-2.1 は 1K、2K、4K に対応しています。nano-banana-pro は最高品質を提供します
  • :official バリアント（例：nano-banana:official）は公式チャネル経由でルーティングされます
  • タスクのポーリングでは、/nano-banana/tasks のリクエスト本文に task_id ではなく id を使用します
  • アスペクト比にはピクセル寸法ではなく、コロン表記（例："16:9"）を使用します
  • Gemini ベースのモデルは、複雑で会話形式の編集指示の理解に優れています

MCP: pip install mcp-nano-banana | ホスト型：https://nanobanana.mcp.acedata.cloud/mcp | すべての MCP サーバーを参照

コメント

Markdown 対応