> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Nano Banana 2 画像生成/編集
> Google の最新画像生成モデル Nano Banana 2 (gemini-3.1-flash-image-preview) - Flash級の速度で Pro レベルの品質、4K出力、14種類のアスペクト比、Image Search Grounding、1回あたり $0.055/image、token ベースで $0.025/image から。
## 概要
**Nano Banana 2**（コードネーム）は、2026年2月26日にリリースされた Google の最新の画像生成モデルで、モデル ID は`gemini-3.1-flash-image-preview`です。**Pro レベルの品質を Flash レベルの速度とコストで実現**し、画像生成の費用対効果を再定義することで、Nano Banana シリーズの最新フラッグシップとなっています。
**🔥 2026年2月26日リリース**: Nano Banana 2 が利用可能になりました！Pro レベルの品質、Flash レベルの速度、Google の料金の最大 36% という低さの token ベース課金！512px が 1 枚あたりわずか \$0.025！4K 出力、14 種類のアスペクト比、Image Search Grounding など、さらに多くの専用機能をサポートします。
**🆕 2026年5月29日更新（`-preview` が廃止）**: Google は公式ドキュメントを更新し、安定版のモデル名 **`gemini-3.1-flash-image`**（`-preview` なし）を公開しました。APIYI はすでにこれをサポートしています。
* **旧名も引き続き使用可能**: `gemini-3.1-flash-image-preview` はこれまでどおり動作し、**価格は変わりません**。コード変更は不要です。
* **どちらの名前でも使用可能**: 新しい `gemini-3.1-flash-image` 名または元の `-preview` 名のどちらでも使えます。
参考までに、Google は安定版がプレビュー版と出力品質、安全フィルタリング、その他の挙動で異なるかどうかを明確にしていません。ぜひテストして、フィードバックをお寄せください。
すべての画像 API は**同期型**です。ポーリングする task ID はなく、クライアントが切断されると、リクエストは課金されたままでも結果は失われます。このモデルには余裕のあるタイムアウトを設定してください。[画像 API の基本とベストプラクティス](/ja/api-capabilities/image-api-best-practices) を参照してください。
テキスト prompt から画像を生成します。オンラインテスト用のインタラクティブなプレイグラウンドが含まれます。
画像と編集指示をアップロードして、新しい画像を生成します。インタラクティブなプレイグラウンドが含まれます。
## なぜAPIYIのNano Banana 2なのか？
**Nano Banana Pro / 2は、APIYIで利用量第1位のモデルです** — 安定していて、信頼性が高く、高速です。プロフェッショナルなチームと一緒に取り組みたいなら、APIYIが最適な選択です。
登場したばかりのGoogleのフラッグシップモデルは、供給元でまだ容量制約があります — APIYIは**信頼性**、**コスト**、**連携**の体験を徹底的に最適化しています：
Google純正のGemini API（`/v1beta/models/.../generateContent`）およびOpenAI SDKパターンと100%互換で、リクエスト本文、レスポンスフィールド、エラーコードも同一です。コード変更なしで移行できます。
Google AI StudioのRPM/RPD上限に縛られません。エンタープライズ規模のバッチ生成やピークトラフィックも、クォータによる中断なしに線形に拡張できます。
1回あたり\$0.055/画像（Googleは\$0.151）、512pxはtokenベースで\$0.025/画像〜（Googleは\$0.045）。[チャージボーナス](/ja/faq/recharge-promotions)と併用すると、定価の30.3%まで下げられます。
**海外サーバーやプロキシは不要です** — 中国本土のデータセンター、個人回線、または海外ノードから`api.apiyi.com`に直接接続できます。安定したレイテンシーで、越境向けの再設計も不要です。
同シリーズで[Nano Banana Pro](/ja/api-capabilities/nano-banana-image/overview)（最高品質）、Nano Banana 2（最もコスパが高い）、旧版のNano Bananaをカバーします。用途ごとに使い分けられます。
当チームは本番環境での画像生成デプロイに特化しており、モデル選定、チューニング、統合に関する深い経験を持っています。PoCから本番導入まで一貫してサポートします。
## コア機能
鮮やかなライティング、豊かな質感、シャープなディテールで、Nano Banana Proに匹敵する品質をより高速で実現します
512px、1K、2K、4Kの解像度に対応し、最大4096×4096まで出力できます
新たに1:4、4:1、1:8、8:1を追加し、合計14種類のアスペクト比でより多くのユースケースをカバーします
Nano Banana 2専用 - Google Image Search から視覚コンテキストを取得します
多言語対応で画像内の文字を明瞭かつ読みやすく描画し、ポスターやマーケティング素材に最適です
chat を通じた反復的な改善で、会話しながら画像編集できます
最小から高レベルまで思考を設定でき、複雑な prompt をより正確に処理します
最大5人のキャラクターと14個の参照オブジェクトにわたって類似性を維持します
## バージョン比較
| 機能 | **Nano Banana 2** | Nano Banana Pro | Nano Banana |
| ------------ | -------------------------------- | ---------------------------- | ------------------------ |
| モデルID | `gemini-3.1-flash-image-preview` | `gemini-3-pro-image-preview` | `gemini-2.5-flash-image` |
| 品質 | ⭐⭐⭐⭐⭐ Proレベル | ⭐⭐⭐⭐⭐ 最高 | ⭐⭐⭐⭐ 優秀 |
| 速度 | 🚀 最速 | 🐢 遅い | ⚡ 速い |
| 最大解像度 | 4K | 4K | 1K |
| アスペクト比 | 14 | 10 | 10 |
| 画像検索グラウンディング | ✅ 独占 | ❌ | ❌ |
| APIYI 料金 | **\$0.055/画像（呼び出しごと）** | \$0.09/画像 | \$0.02/画像 |
| ステータス | プレビュー | プレビュー | 一般提供開始 |
**選定ガイド**:
* 🔥 **最もお得** → Nano Banana 2（tokenベースで \$0.025/画像から、Proレベルの品質 + Flash級の速度）
* 🎨 **究極の品質** → Nano Banana Pro（\$0.09/画像、最高の忠実度）
* ⚡ **最安コスト** → Nano Banana（\$0.025/画像、高速で安定）
## 料金
**課金モードの選択**: Nano Banana 2 は 2 つの課金モードに対応しており、API token を作成する際の「課金モデル」設定で選択します:
* **Pay-as-you-go** または **Pay-as-you-go Priority** を選択 → token ベース課金
* **Pay-per-request** または **Pay-per-request Priority** を選択 → リクエストごとの課金（Nano Banana Pro と同じ）
* ⚠️ **Hybrid billing は選択しないでください**
### 呼び出しごとの課金
| Model | APIYI Pricing | Google Official 4K | 割引 |
| -------------------------------------------------- | ----------------- | ------------------- | ------------- |
| **Nano Banana 2** `gemini-3.1-flash-image-preview` | **\$0.055/image** | \$0.151/image | **🔥 約64%オフ** |
| Nano Banana Pro `gemini-3-pro-image-preview` | \$0.09/image | \$0.24/image | **約63%オフ** |
| Nano Banana `gemini-2.5-flash-image` | \$0.02/image | \$0.039/image（1Kのみ） | 約50%オフ |
**エンタープライズ HA チャネル**: NanoBananaEnterprise は標準の Nano Banana Pro レートの 1.4 倍（\$0.126/image）で利用でき、エンタープライズ向けワークロードに専用の高可用性フォールバックを提供します。
### tokenベース課金（Nano Banana 2 専用）
| 課金項目 | Google Official | APIYI | 割引 |
| --------------------- | --------------------------- | --------------- | ------- |
| 入力 | \$0.50/M tokens | \$0.18/M tokens | **36%** |
| 出力（images と text を統合） | Images \$60/M, Text \$1.5/M | \$21.6/M tokens | **36%** |
### tokenベース課金の料金目安
| 解像度 | Google Official | APIYI | Fal AI |
| ----- | --------------- | ------------ | ------ |
| 512px | \$0.045 | **約\$0.025** | \$0.06 |
| 1K | \$0.067 | **約\$0.035** | \$0.08 |
| 2K | \$0.101 | **約\$0.045** | \$0.12 |
| 4K | \$0.151 | **約\$0.07** | \$0.16 |
**💰 tokenベース課金のほうがさらにお得です!** tokenベース課金なら、512px 画像は \$0.025 から利用でき、Google の料金のわずか 36% です。低解像度のユースケースでは、呼び出しごとの課金（\$0.055/image）よりもかなり安くなります。4K では tokenベース料金（約 \$0.07）のほうが呼び出しごとの課金よりもさらに安く、どちらも Google 公式の \$0.151/image を大きく下回ります。チャージ特典と組み合わせることで、実際のコストはさらに下がります。
## グループ設定
Nano Banana 2 は APIYI で 2 つのグループとして提供されています。ダッシュボード → **トークン設定** で切り替えます:
| グループ | レート | 使用タイミング |
| ---------------------- | ---- | -------------------------------------------------------------- |
| `Default` | 1.0x | ベースレーン。価格表と一致します。推奨のデフォルトです |
| `NanoBananaEnterprise` | 1.4x | フォールバックレーン — デフォルトが逼迫しているときやタイムアウトが急増したときに手動で切り替えます。キャパシティ優先です |
**なぜ 1.4x なのですか？** 1.4x でも、価格は Google の定価の約 50% にとどまり、公式価格よりはるかに安いです。これは、より高い同時実行数のワークロードや予期しない upstream のリスク制御イベント向けのフォールバックレーンであり、エンタープライズのお客様に高可用性の保証を提供します。デフォルトグループが逼迫しているときは、Token を `NanoBananaEnterprise` に切り替えて急増をやり過ごしてください。
**推奨の課金モデル**: `Pay-as-you-go Priority` を選んでください — Nano Banana 2 の token ベース課金と Nano Banana Pro の per-call 課金の両方をカバーし、**シリーズ全体で 1 つの Token** です。
**さらに進める場合**: あなたの Token が他の画像モデル（例: GPT-image-2）もカバーしているなら、より安定している `Default` をプライマリグループにし、`NanoBananaEnterprise` をフォールバック枠に入れてください — プライマリで 429 が発生しても、token swap なしでエンタープライズグループへ自動フェイルオーバーします。
## 対応解像度とアスペクト比
### 出力解像度
| 解像度 | 説明 | 推奨用途 |
| ----- | ----- | ---------------------- |
| 512px | 低解像度 | サムネイル、クイックプレビュー |
| 1K | デフォルト | ソーシャルメディア、Web表示 |
| 2K | 高精細 | HDディスプレイ、印刷物 |
| 4K | 超高精細 | プロフェッショナルなデザイン、商業用ポスター |
### 対応アスペクト比（全14種）
`1:1`, `1:4`, `4:1`, `1:8`, `8:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`
### アスペクト比ごとの出力サイズ（ピクセル）
以下の表は、512px / 1K / 2K / 4K の各解像度階層における、Nano Banana 2 の14種類すべてのアスペクト比に対する実際の出力サイズを示しています（出典: Googleの公式ドキュメント）。リクエストでは、比率に `aspect_ratio` を、階層に `image_size`（または `resolution`）を指定してください。
| アスペクト比 | 512px | 1K | 2K | 4K |
| -------- | -------- | --------- | --------- | ---------- |
| **1:1** | 512×512 | 1024×1024 | 2048×2048 | 4096×4096 |
| **1:4** | 256×1024 | 512×2048 | 1024×4096 | 2048×8192 |
| **1:8** | 192×1536 | 384×3072 | 768×6144 | 1536×12288 |
| **2:3** | 424×632 | 848×1264 | 1696×2528 | 3392×5056 |
| **3:2** | 632×424 | 1264×848 | 2528×1696 | 5056×3392 |
| **3:4** | 448×600 | 896×1200 | 1792×2400 | 3584×4800 |
| **4:1** | 1024×256 | 2048×512 | 4096×1024 | 8192×2048 |
| **4:3** | 600×448 | 1200×896 | 2400×1792 | 4800×3584 |
| **4:5** | 464×576 | 928×1152 | 1856×2304 | 3712×4608 |
| **5:4** | 576×464 | 1152×928 | 2304×1856 | 4608×3712 |
| **8:1** | 1536×192 | 3072×384 | 6144×768 | 12288×1536 |
| **9:16** | 384×688 | 768×1376 | 1536×2752 | 3072×5504 |
| **16:9** | 688×384 | 1376×768 | 2752×1536 | 5504×3072 |
| **21:9** | 792×168 | 1584×672 | 3168×1344 | 6336×2688 |
Nano Banana Pro の10個のアスペクト比と比べると、Nano Banana 2 では `1:4`、`4:1`、`1:8`、`8:1` が追加されており、長尺画像やインフォグラフィックに最適な超縦長/超横長の比率です。また、512px の低解像度階層を備える唯一のモデルで、サムネイルやクイックプレビューに最適です。
## よくある質問
**Nano Banana 2** (`gemini-3.1-flash-image-preview`) は Gemini 3.1 Flash をベースにしており、**Nano Banana Pro** (`gemini-3-pro-image-preview`) は Gemini 3 Pro をベースにしています。主な違い:
* ✅ **速度**: Nano Banana 2 のほうが高速です（Flash 相当の速度）
* ✅ **価格**: Nano Banana 2 の token ベース課金のほうが安価です（\$0.025 から vs \$0.09）
* ✅ **アスペクト比**: Nano Banana 2 は 14 種類に対応しています（4 つ多いです）
* ✅ **画像検索グラウンディング**: Nano Banana 2 専用です
* ⚠️ **最終的な品質**: Nano Banana Pro のほうがなお少し上です
**おすすめです！** Nano Banana 2 は、より低価格でより高速ながら、Pro に近い品質を提供します。極端に高い品質要件がない限り、Nano Banana 2 のほうがより良い選択です。
モデル名を `gemini-3-pro-image-preview` から `gemini-3.1-flash-image-preview` に変更するだけです。
**コード / API 呼び出しでは、`gemini-3.1-flash-image-preview`（`-4k` サフィックスなし）という一般的なモデル名を常に使うことをおすすめします。`gemini-3.1-flash-image-preview-4k` ではありません。**
* **公式名には `-4k` がありません**: Google の公式モデル名は `gemini-3.1-flash-image-preview` です。ここは当社が最も多くのリソースを投じて維持している一般チャネルでもあるため、最も高い安定性と互換性を提供します。
* **`-4k` の由来**: `gemini-3.1-flash-image-preview-4k` は、Chatbox のような会話型クライアントでの「チャットから画像生成」シナリオ向けに用意された設定でした。メッセージ UI のチャットから直接画像を生成する用途です。
* **コード + Gemini ネイティブ形式では一般名が有利**: Gemini のネイティブ形式（`/v1beta/models/.../generateContent`）でコードから呼び出す場合、通常のモデル名 `gemini-3.1-flash-image-preview` のほうが安定しています。
4K 出力が必要な場合でも、`-4k` モデル名に頼る必要はありません。リクエストパラメータで 4K 解像度を指定するだけで大丈夫です（上の「サポートされる解像度とアスペクト比」を参照してください）。
Image Search Grounding は Nano Banana 2 専用機能です。Google Image Search から視覚コンテキストを取得して、実世界の被写体により合う画像を生成します。たとえば、実在のランドマークの画像を生成する際に、検索結果を参照して精度を高められます。
Thinking Mode により、画像生成前にモデルが推論して分析できるため、複雑な prompt の精度が向上します。`high` に設定すると最良の結果が得られますが、生成時間は少し長くなります。正確な構図、文字レンダリング、複雑なシーンが必要なタスクに最適です。
生成時間は解像度と Thinking Mode によって異なります:
* **1K 解像度**: 約 5〜10 秒
* **2K 解像度**: 約 10〜15 秒
* **4K 解像度**: 約 15〜25 秒
* 高い Thinking Mode を有効にすると、さらに数秒かかります
まれな遅延やピーク時の混雑に備えて、長めのタイムアウト（少なくとも 360 秒）を設定することをおすすめします。
**API には同時実行数の制限はなく、逐次処理でもありません。** ご自身で安全に並列リクエストを送れます。リクエスト同士がキューで待たされたり、互いにブロックし合ったりすることはありません。20 人のユーザーが同時に呼び出す場合は、20 件の並列リクエストを送るだけで大丈夫です。追加のクォータ申請やスロットリングは不要です。
Google AI Studio と異なり、APIYI チャネルには厳格な RPM/RPD 制限がないため、エンタープライズの一括生成やピークトラフィックでも線形にスケールします。
**実際に重要なのは `timeout` です**: 画像生成（特に 4K やピーク時の混雑時）は 1 リクエストあたり時間がかかることがあるため、**クライアントのタイムアウトを 360 秒に設定**して、通常どおり処理中のリクエストが途中で切れないようにしてください。
まれに 429（高い同時実行数によるスロットリング）になる場合は、token のフォールバックグループとして `NanoBananaEnterprise` を追加してください（上の「グループ設定」を参照）。プライマリグループが飽和すると自動でフォールバックし、高い同時実行数でも成功率がさらに向上します。
`image/png` と `image/jpeg` 形式に対応しています。base64 エンコードまたは Files API でアップロードできます。
出力画像にはすべて SynthID の目に見えないデジタル透かし（Google の AI 生成コンテンツ識別技術）が含まれます。肉眼では見えず、利用にも影響しません。
エラー全文は次のとおりです:
```text theme={null}
[&{{write tcp ip:port->ip:port: write: connection reset by peer Unknown error shell_api_error write_response_body_failed} 500 }]
```
これは**たいてい、画像アップロードが大きすぎることが原因です。request body が大きくなりすぎて接続が切れます**。次のベストプラクティスに従ってください:
* **画像枚数を制限する**: 公式ルールの範囲内（1 prompt あたり最大 14 枚）に収め、参照画像を詰め込みすぎないでください。
* **画像 1 枚あたりのサイズを制限する**: 各画像を 5MB 未満にしてください。公式の 1 枚あたり上限は 7MB ですが、base64 エンコードでサイズが約 1/3 増えるため、余裕を持たせてください。
* **アップロード前にフロントエンドで圧縮する**: API に送る前に、フロントエンド（またはサーバー側のリレー）で画像を圧縮してください。一般的には、長辺を制限し、JPEG/WebP に変換し、quality パラメータを調整します。
* **URL 入力に切り替える**: Gemini のネイティブ形式では、`fileData.fileUri` を使って画像 URL を渡せるため、巨大な base64 の request body を完全に回避できます。詳しくは [Nano Banana 開発ガイド](/ja/api-capabilities/nano-banana-dev-guide) をご覧ください。
## 関連ドキュメント
* [Nano Banana Pro 画像生成](/en/api-capabilities/nano-banana-image) - 前のフラッグシップ版
* [Nano Banana 画像編集](/en/api-capabilities/nano-banana-image-edit) - 画像編集機能
* [画像生成比較テスト](https://imagen.apiyi.com/)
* [API 利用マニュアル](/ja/api-manual)
Nano Banana 2 は現在プレビュー状態です。機能と価格は調整される場合があります。最新情報はドキュメントの更新をご確認ください。