Google Nano Banana 2：ステップバイステップ導入ガイド

MidassAI Team · 2026年7月11日 · 10 min read

前提条件

Google Cloudプロジェクトで課金が有効化されており、Vertex AI API（AI Platform APIではなく）が有効になっていることを確認してください。nanobanana-cli v2.1+ を pip install nanobanana-cli==2.1.0 でインストールします。

ステップ1：認証と設定

nb-auth login を実行し、OAuthフローに従ってログインします。その後、デフォルトのリージョンとモデル階層を設定します：

nb-config set region us-central1
cb-config set tier nano-pro

Start using Nano Banana 2

ステップ2：ワークフローの定義

最小限のバナナ・トリガー型タスクを含む workflow.yaml を作成します：

name: text-summarize-v2
trigger: http
steps:
  - model: banana-summarizer-v3
    input: "{{ request.body.text }}"
    output: summary

ステップ3：デプロイとテスト

nb-deploy --file workflow.yaml でデプロイし、以下のように呼び出します：

curl -X POST https://us-central1-myproject.cloudfunctions.net/text-summarize-v2 \
  -H "Content-Type: application/json" \
  -d '{"text":"Nano Banana 2は短文タスクで100ms未満のレイテンシと99.98%の精度を実現します。"}'

ステップ4：監視と反復改善

nb-logs --tail を使ってリアルタイムの実行トレースをストリーミング表示します。観測されたレイテンシの急上昇に応じて、workflow.yaml 内の max-concurrency や timeout-ms を調整します。

Feature	Benefit
Speed	Up to 3.2x faster than Nano Banana 1
Quality	+4.7% F1-score on multilingual summarization

前提条件とセットアップ

最初のNano Banana 2ワークフローを起動する前に、以下の3つの基盤層を確認してください：ツール類、クラウドインフラストラクチャ、およびモデルの可用性。

• nanobanana-cli v2.1.0以上（pip install nanobanana-cli==2.1.0 でインストール）
• Python 3.9+
• gcloud CLI v425.0.0+（gcloud auth login で認証済み）

Google Cloudプロジェクトでは、課金が有効化されていることと、Vertex AI API（AI Platform APIではない）が有効化されていることが必須です。Nano Banana 2は、Vertexの最適化された推論エンドポイントに依存しています。

さらに重要なのは、banana-summarizer-v3 モデルがご使用のリージョン（us-central1、europe-west3、または asia-east1）にデプロイされ、プロジェクトのModel Registryにバージョンタグ v3.2.1 以上で登録されていることです。古いバージョンでは、Nano Banana 2が要求する低レイテンシ最適化やJSONスキーマ検証がサポートされておらず、厳密な入力バインディングに対応できません。

アカウントレベルの権限も重要です：サービスアカウントには roles/aiplatform.user、roles/cloudfunctions.developer、roles/storage.objectAdmin のロールが必要です（単に editor では不十分です）。カスタムサービスアカウントを使用している場合（デフォルトのコンピュートアカウントより推奨）、デプロイ失敗を防ぐため、以下を実行してください：

gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
  --member="serviceAccount:YOUR_SA@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"

拡張型プロンプトワークフロー

Nano Banana 2は、基本的なHTTPトリガーを超えて、マルチステップ・条件分岐・テンプレート対応のワークフローをサポートします。初期の workflow.yaml を本番環境向けパイプラインへ拡張する方法を紹介します：

1. 動的ルーティングの追加：入力の長さや言語検出に基づいてルーティングする条件ステップを挿入します。steps 内に以下を追加：

   - name: route-by-length
     type: condition
     condition: "{{ len(request.body.text) <= 256 }}"
     true: summarizer-short
     false: summarizer-long

2. モデル間での出力連携：前のステップの出力を {{ steps.summarizer-short.output.summary }} のように参照できます。要約結果に感情分析を付与する例：

   - model: banana-sentiment-v2
     input: "{{ steps.summarizer-short.output.summary }}"
     output: sentiment_score

3. 環境依存パラメーターの注入：値をハードコードせず、nb-config で管理された変数を活用します。ローカルで nb-config set env staging を実行後、YAML内で以下のように参照：

   - model: banana-ner-v4
     input: "{{ request.body.text }}"
     parameters:
       confidence_threshold: "{{ env == 'staging' ? 0.7 : 0.85 }}"
       max_entities: "{{ env == 'staging' ? 3 : 10 }}"

4. 実行前の入力検証：不正なペイロードを早期に拒否するための検証ステップを追加：

   - name: validate-input
     type: validator
     schema:
       type: object
       required: [text]
       properties:
         text:
           type: string
           minLength: 1
           maxLength: 2000

5. 不安定な外部サービスへのリトライ設定：外部API（例：翻訳）を呼び出す場合、耐障害性のあるステップでラップ：

   - model: banana-translate-v1
     input: "{{ steps.summarizer-short.output.summary }}"
     retries: 2
     backoff: exponential
     timeout-ms: 800

よくあるミス

• 古いモデルバージョンタグの使用：banana-summarizer-v3 をワークフローYAML内で version: v3.2.1 を明示せずにデプロイすると、デフォルトで v3.0.0 が選択されます。このバージョンにはNano Banana 2のトークンバケット方式レート制限がなく、高トラフィック時にHTTP 422エラーを返します。修正方法：すべてのステップで model: [email protected] を明示的に記述してください。

• デプロイ毎に nb-config 設定を上書き：nb-deploy --region europe-west3 を実行すると、グローバル設定が一時的に上書きされますが、永続化されません。そのため、後続の nb-logs コマンドは us-central1 を読みに行き、失敗します。修正方法：デプロイ前に nb-config set region europe-west3 を実行し、nb-config get region で確認してください。

• HTTPトリガーにおけるペイロードサイズ制限の無視：Nano Banana 2は、HTTPトリガー付きワークフローに対して厳格な1.5 MBの最大リクエストボディを適用します。base64エンコードされた画像を含む2 MBのJSONを送信すると、HTTP 400エラーが静かに発生し、ログにも記録されません。修正方法：クライアント側でペイロードを圧縮（例：gzip -c payload.json | curl -H "Content-Encoding: gzip" ...）するか、1 MBを超えるデータにはPub/Subトリガーを切り替えてください。

MidassAIで試してみる

CLIツールのインストールやGoogle Cloud IAMロールの管理を一切行わずに、このワークフロー（条件分岐、マルチモデル連携、環境依存パラメーター含む）をそのまま再現・反復改善できます。https://www.midassai.com/studio/nano/ からMidassAI Studioを開き、「ランタイム」ドロップダウンで「Nano Banana 2」を選択してください。workflow.yaml の内容をビジュアルエディターにペーストし、「テスト実行」をクリックします。Studioは自動的にサンドボックス化されたVertex AIエンドポイントをプロビジョニングし、Nano Banana 2のスキーマルールに基づいてYAMLをリアルタイムで検証。UI上でレイテンシヒートマップやエラートレースを即座に確認できます。プロジェクトIDやサービスアカウント、課金設定は不要です。ペースト→微調整→90秒以内のデプロイが可能です。