メインコンテンツへスキップ

​
概要

Nano Banana 2（コードネーム）は、2026年2月26日にリリースされたGoogleの最新画像生成モデルで、モデルIDはgemini-3.1-flash-imageです。Proレベルの品質をFlashクラスの速度とコストで実現し、画像生成のコストパフォーマンスを刷新する、Nano Bananaシリーズの最新フラッグシップモデルです。
🔥 2026年2月26日リリース: Nano Banana 2が利用可能になりました！Proレベルの品質、Flashクラスの速度、Googleの価格のわずか36%から利用できるtokenベースの課金を実現！512px画像はわずか$0.025/枚から！4K出力、14種類のアスペクト比、Image Search Groundingなど、独自機能にも対応しています。
🆕 2026年5月29日更新（-preview廃止）: Googleが公式ドキュメントを更新し、安定版モデル名 gemini-3.1-flash-image（-previewなし）をリリースしました。APIYIではすでに対応しています。
  • このドキュメントでは、安定版の名称を全編で使用しています gemini-3.1-flash-image — 新しいインテグレーションではこちらを使用してください。
  • 旧名称も引き続き使用できます: gemini-3.1-flash-image-previewはこれまでどおり動作し、価格も変わりません。コードの変更は不要です。
注意: Googleは、安定版とプレビュー版で出力品質、安全フィルタリング、その他の動作に違いがあるかどうかを明らかにしていません。ぜひお試しいただき、フィードバックをお寄せください。
🆕 2026年10月6日: Nano Banana 2.1がリリースされました（gemini-nano-banana-2.1）。Googleは新しいプロジェクトに2.1を推奨しています。品質、テキストレンダリング、複数ターンでの一貫性が向上し、APIYIでは1リクエストあたり$0.045で利用できます（10月13日より$0.05から値下げ）。Nano Banana 2も同じ価格で引き続き利用できます。Nano Banana 2.1の画像生成・編集をご覧ください。
すべての画像APIは同期処理です。ポーリングするタスクIDはなく、リクエストの処理中にクライアントが切断されると、課金されたまま結果が失われます。このモデルでは十分に長いタイムアウトを設定してください。画像APIの基本とベストプラクティスをご覧ください。

テキストから画像へのAPI

テキストpromptから画像を生成します。オンラインテスト用のインタラクティブなプレイグラウンドが含まれています。

画像編集API

画像と編集指示をアップロードして、新しい画像を生成します。インタラクティブなプレイグラウンドが含まれています。

​
AIエージェントに統合を任せる

このpromptをコピーしてCodex / Claude Code / Cursorに貼り付けてください

このpromptは、まずこのページのプレーンテキスト版を取得し（任意のドキュメントURLの末尾に.mdを追加）、プロジェクト独自のスタックに合わせてコードを記述します。タイムアウト、防御的なpartsのパース、アップロード時の圧縮、解像度パラメータなどがすでに要件として組み込まれています。

このプロジェクトにNano Banana 2（gemini-3.1-flash-image）のtext-to-imageおよび画像編集を統合／トラブルシューティングしてください。

コードに手を付ける前にドキュメントを読んでください：このページのプレーンテキスト版を取得するには、https://docs.apiyi.com/en/api-capabilities/nano-banana-2-image/overview.md をfetchしてください。より詳細なパラメータについては、末尾に…を追加してください

  1. タイムアウト：POST https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image:generateContentでGeminiネイティブ形式を呼び出し、クライアントのタイムアウ…

合計7つの要件があります。下のボタンを使用して完全なpromptをコピーしてください。

​
APIYIのNano Banana 2が選ばれる理由

Nano Banana Pro / 2 は、APIYIで利用量第1位のモデルです — 安定、高信頼、高速です。プロフェッショナルなチームと仕事をしたいなら、APIYIが最適です。 リリースされたばかりのGoogleのフラッグシップは、供給元でなおキャパシティ制約があります — APIYIは、信頼性、コスト、統合の各面で体験を徹底的に最適化します。

Official Channel · Same as Gemini

GoogleのネイティブGemini API（/v1beta/models/.../generateContent）およびOpenAI SDKパターンと100%互換です — リクエストボディ、レスポンスフィールド、エラーコードは同一です。ゼロコード移行が可能です。

No Concurrency Limits

Google AI StudioのRPM/RPD上限に縛られません。エンタープライズ規模のバッチ画像生成とピーク時トラフィックも、クォータによる中断なく線形にスケールします。

28-36% of Google's List Price

1画像あたり$0.055（Googleの$0.151に対して）、512pxはtokenベースで1画像あたり$0.025から（$0.045に対して）。チャージ特典と組み合わせると、定価の30.3%まで下げられます。

Global Zero-Barrier Access

海外サーバーやプロキシは不要です — 中国本土のデータセンター、家庭用ネットワーク、または海外ノードからapi.apiyi.comへ直接接続できます。レイテンシは安定しており、越境向けの再設計も不要です。

Full Model Lineup

同一シリーズでNano Banana Pro（最高画質）、Nano Banana 2（最もコスパが高い）、そして旧Nano Bananaをカバーします — 用途に応じて使い分けられます。

Professional Enterprise Support

当チームは本番環境での画像生成導入を専門としており、モデル選定、チューニング、統合に深い経験があります — PoCから本番までエンドツーエンドで支援します。

​
主な機能

Proレベルの品質

鮮やかなライティング、豊かなテクスチャ、シャープなディテール - Nano Banana Pro に匹敵する品質を、はるかに高速で実現します

4K Ultra-HD 出力

512px、1K、2K、4K の解像度をサポートし、最大 4096×4096 まで対応します

14種類のアスペクト比

新規追加: 1:4、4:1、1:8、8:1 - 合計14種類のアスペクト比で、より多くのユースケースをカバーします

画像検索グラウンディング

Nano Banana 2 専用 - Google Image Search からビジュアルコンテキストを取得します

正確なテキストレンダリング

多言語対応で、画像内の文字を鮮明かつ読みやすく表示します - ポスターやマーケティング素材に最適です

マルチターン編集

チャットを通じて段階的に洗練できる、対話型の画像編集です

Thinkingモード

より正確に複雑な prompt を処理できるよう、最小限または高い Thinking レベルを設定できます

被写体の一貫性

最大5人のキャラクターと14個の参照オブジェクトにわたって類似性を維持します

​
バージョン比較

選択ガイド:
  • 🔥 最高のコストパフォーマンス → Nano Banana 2（tokenベースで$0.025/画像、Proレベルの品質とFlashクラスの速度）
  • 🎨 最高品質 → Nano Banana Pro（$0.09/画像、最高の忠実度）
  • ⚡ 最低コスト → Nano Banana（$0.025/画像、高速で安定）

​
料金

課金モードの選択: Nano Banana 2 は、API token の作成時に「課金モデル」設定で選択できる2つの課金モードに対応しています:
  • 従量課金または**従量課金（優先）**を選択 → トークンベース課金
  • リクエストごとの課金または**リクエストごとの課金（優先）**を選択 → 呼び出しごとの課金（Nano Banana Pro と同じ）
  • ⚠️ ハイブリッド課金は選択しないでください

​
呼び出しごとの課金

エンタープライズ向けHAチャネル: NanoBananaEnterprise は標準の Nano Banana Pro の料金の1.4倍（$0.126/画像）で利用でき、エンタープライズのワークロード向けに専用の高可用性フォールバックを提供します。

​
トークンベース課金（Nano Banana 2 限定）

​
トークンベース課金の料金目安

💰 トークンベース課金ならさらにお得です! トークンベース課金では、512px の画像をわずか $0.025 から利用できます。Google の料金のわずか36%です! 低解像度の用途では、呼び出しごとの課金（$0.055/画像）より大幅に安くなります。4K でもトークンベースの料金（約$0.07）は呼び出しごとの課金より安く、どちらも Google公式の $0.151/画像を大きく下回ります。チャージ特典を組み合わせると、実際のコストはさらに低くなります。

​
課金に影響する3つのパラメータ

以下の数値は、2026-08-27 に本番ゲートウェイに対して実施したライブテストに基づきます（各条件12～20回実行、いずれも推定ではなくコンソールに記録された実際の課金額に基づいています）。これらが課金に与える影響は2桁違うため、示した順に最適化してください。

​
thinkingLevel: デフォルトはすでに最小で、high はさらに50％増しです

gemini-3.1-flash-image は thinking-level の制御をサポートします（Pro にはありません）。同じ prompt を使い、それぞれ20回実行しました。
  • デフォルトは minimal と同一です — 統計的に区別できず（p=0.64）、minimal を明示的に渡しても何も得られません。
  • high のときだけ thoughtsTokenCount が独立したフィールドとして現れ、completion_tokens に折り込まれて画像生成レートで課金されます。
  • 複雑な prompt でコストが上がるのは high がオンのときだけです: デフォルトレベルでは、3-token の prompt と 98-token の reasoning prompt で出力 tokens に有意差はありませんでした（p=0.37）。high では、reasoning prompt が thinking tokens を 126% 多く使い、1回あたりの課金は 38% 増 でした。
日常的な生成ではこのパラメータはそのままにしてください。high を有効にするのは、構図ロジック、画像内テキストのレイアウト、またはチャートの比率精度に厳しい要件がある場合だけです。その代わり、支出は+54%、レイテンシは+55% になります。

​
Google Search グラウンディング: 動作しますが、検索クエリごとに課金されます

天気カード、マーケットチャート、イベントポスターのように、正確さのために最新情報が必要な画像には、googleSearch ツールを付けてください。グラウンディングは12/12回で発生しました。
output tokens への影響はごくわずかです（検索料金を除くと、ツールなしのコントロール比で −2.1%、有意差なし）。コスト全体は検索呼び出し自体によるもので、1回 $0.014 です。
何回検索するかはモデルが決めます。事前に設定はできません。 テストでは、1回の画像リクエストが自動的に1～3件のクエリを発行したため、このツールを有効にすると1回あたりの課金は $0.050～$0.078 の範囲になり、固定値ではありません。予算は上限で見積もってください。

​
Image Search グラウンディング: Nano Banana 2 専用で、現時点では無料

searchTypes.imageSearch を使うと、モデルは Google Image Search から視覚的な参照を取得できます。これは「実写写真からコラージュを作る」や「実物をそのまま描く」といった用途に便利です。
  • imageSearchQueries が groundingMetadata に現れ、["current weather in Tokyo"] のような値を示すことで確認されました。
  • 現時点では追加課金はありません — 1回あたりの課金は、ツールなしのコントロールよりわずかに低い結果でした。
  • 12回中7回で発生しました: 検索するかどうかはモデルが決めます。毎回問い合わせるわけではありません。
  • Web search と image search は同時に有効化できますが、どちらを使うかはモデルが選ぶため、コストは予測不能になります。
searchTypes は配列ではなくオブジェクトでなければなりません。✅ {"searchTypes": {"imageSearch": {}}} — 動作します❌ {"searchTypes": ["imageSearch"]} — エラーは出ず、200 が返り、画像も取得できますが、image search は一度も発火しません。 レスポンス本文にはそれが何も示されません。配列形式に対する上流エラーは Proto field is not repeating, cannot start list です。

​
responseModalities: 何も節約できませんが、不要なテキストを除去します

responseModalities: ["IMAGE"] は画像のみを希望することを示します。各20回実行しました。
  • 3つとも互いに1%以内で、["TEXT","IMAGE"] はフィールドを省略した場合と完全に同じです（p=0.90）。
  • 通常の生成 prompt では、60/60 のレスポンスがすでに1つの image part だけを含み、テキストは一切ありませんでした。そのため、このモダリティ切り替えには作用対象がありません。推論 prompt（インフォグラフィック、データチャート）の場合だけ、約3分の1の確率で要約段落が付加されます。そこでは ["IMAGE"] がそれを抑制し、約 2.8% 節約できます（p=0.09、有意ではありません）。
節約できるものがない理由: output tokens は「image + text」ではなく、画像用の1120 tokens に加えて、目に見えない約400 tokens のオーバーヘッドだからです。そのオーバーヘッドは candidatesTokensDetails のどのフィールドにも現れませんが、正規レートで課金され、1回あたりの課金の28%を占めます。また、prompt 長によって変動しません。テキストの量はそれに比べればごくわずかです。つまり、1120 tokens から1画像あたりのコストを見積もると 約28% 過小評価 になります。代わりに candidatesTokenCount または totalTokenCount と突き合わせてください。

​
グループ設定

Nano Banana 2 には APIYI 上で 2 つのグループが用意されています。ダッシュボード → Token 設定 で切り替えます: なぜ 1.4x なのですか? 1.4x でも、価格は Google の定価の約 50% で、公式価格を大きく下回ります。これは高同時実行数のワークロードや予期しない上流のリスク制御イベント向けのフォールバック レーンであり、エンタープライズのお客様に高可用性保証を提供します。デフォルト グループが逼迫したら、スパイクをやり過ごすために Token を NanoBananaEnterprise に切り替えてください。 推奨課金モデル: Pay-as-you-go Priority を選んでください — Nano Banana 2 の token ベース課金と Nano Banana Pro の呼び出しごとの課金の両方をカバーし、シリーズ全体で Token 1 つ。
Token 作成 UI: 課金モデル「従量課金優先」は NB2 の token ベース課金 + NB Pro の呼び出しごとの課金をカバーします。主要グループ Default + フォールバック グループ NanoBananaEnterprise (1.4x レーン)

Token settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)

さらに進める場合: Token が他の画像モデル（例: GPT-image-2）もカバーする場合は、より安定している Default を主要グループとして、NanoBananaEnterprise をフォールバック枠に入れてください — 主要グループで 429 が発生しても、token の切り替えなしでエンタープライズ グループへ自動フェイルオーバーします。

​
対応解像度とアスペクト比

​
出力解像度

​
対応アスペクト比（全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

​
アスペクト比ごとの出力寸法（pixels）

以下の表は、Nano Banana 2 の 512px / 1K / 2K / 4K の各解像度レベルにおける、全14アスペクト比の実際の出力寸法を示しています（出典: Google 公式ドキュメント）。リクエストでは、比率には aspect_ratio を、レベルには image_size（または resolution）を指定してください。
Nano Banana Pro の10アスペクト比と比べると、Nano Banana 2 では 1:4、4:1、1:8、8:1 が追加されます。これらは、長尺画像やインフォグラフィックに最適な超縦長/超横長比率です。また、512px の低解像度レベルを備える唯一のモデルであり、サムネイルやクイックプレビューに最適です。

​
FAQ

Nano Banana 2 (gemini-3.1-flash-image) はGemini 3.1 Flashをベースにしているのに対し、Nano Banana Pro (gemini-3-pro-image) はGemini 3 Proをベースにしています。主な違いは次のとおりです。
  • ✅ 速度: Nano Banana 2のほうが高速です（Flashクラスの速度）
  • ✅ 価格: Nano Banana 2はtokenベースの課金がより安価です（$0.025から、Nano Banana Proは$0.09から）
  • ✅ アスペクト比: Nano Banana 2は14種類に対応しています（4種類多く対応）
  • ✅ 画像検索グラウンディング: Nano Banana 2限定の機能です
  • ⚠️ 最高品質: Nano Banana Proのほうが、依然としてわずかに高品質です
おすすめです！ Nano Banana 2は、より低価格かつ高速で、Nano Banana Proに近い品質を実現します。極めて高い品質が必要な場合を除き、Nano Banana 2のほうがおすすめです。モデル名をgemini-3-pro-imageからgemini-3.1-flash-imageに変更するだけです。
コード/API呼び出しでは、-4kサフィックスのない汎用モデル名gemini-3.1-flash-imageを常に使用することをおすすめします。gemini-3.1-flash-image-4kは使用しないでください。
  • 公式名称に-4kはありません: Googleの公式モデル名はgemini-3.1-flash-imageです。これは、当社が最も多くのリソースを投入して維持している汎用チャネルでもあるため、最も安定性と互換性に優れています。
  • -4kの由来: gemini-3.1-flash-image-4kは、Chatboxのような会話型クライアントで、メッセージングUIから直接画像を生成する「チャットから画像生成」のシナリオ向けに用意された設定が元になっています。
  • コードとGeminiネイティブ形式では汎用名が適しています: Geminiネイティブ形式（/v1beta/models/.../generateContent）を使ってコードから呼び出す場合は、通常のモデル名gemini-3.1-flash-imageのほうが安定しています。
4K出力が必要な場合でも、-4kモデル名を使う必要はありません。リクエストパラメーターで4K解像度を指定してください（上記の「対応解像度とアスペクト比」を参照）。
画像検索グラウンディングは、Nano Banana 2限定の機能です。Google画像検索から視覚的なコンテキストを取得して、現実世界の対象により合った画像を生成します。たとえば、実在するランドマークの画像を生成する際に、検索結果を参照して精度を高めることができます。
思考モードを有効にすると、画像を生成する前にモデルが推論・分析を行い、複雑なpromptに対する精度が向上します。highに設定すると最良の結果が得られますが、生成時間がわずかに長くなります。正確な構図、テキスト描画、複雑なシーンが必要なタスクに適しています。
生成時間は解像度と思考モードによって異なります。
  • 1K解像度: 約5～10秒
  • 2K解像度: 約10～15秒
  • 4K解像度: 約15～25秒
  • 高度な思考モードを有効にすると、数秒ほど長くなります
まれな遅延や混雑のピークに備えて、長めのタイムアウト（最低360秒）を設定することをおすすめします。
APIに同時実行数の制限はなく、逐次処理も行いません。 リクエストはキューに入ったり、互いにブロックしたりしないため、安心して並行して送信できます。20人が同時に呼び出す場合は、20件のリクエストを並行して送信するだけでよく、追加のクォータ申請やスロットリングは不要です。Google AI Studioとは異なり、APIYIチャネルには厳格なRPM/RPD制限がないため、エンタープライズ向けの一括生成やピーク時のトラフィックにも比例して対応できます。実際に重要なのはtimeoutです: 画像生成（特に4Kや混雑のピーク時）はリクエストごとに時間がかかる場合があるため、正常に処理中のリクエストが途中で打ち切られないよう、クライアントのタイムアウトを360秒に設定してください。
まれに429（同時実行数が多いためスロットリングされた場合）が発生する場合は、tokenのフォールバックグループとしてNanoBananaEnterpriseを追加してください（上記の「グループの設定」を参照）。プライマリーグループが飽和すると自動的にフォールバックするため、同時実行数が多い状況での成功率がさらに向上します。
image/png形式とimage/jpeg形式に対応しています。base64としてインラインで渡すか、fileData.fileUriを使用して公開画像URLを渡してください。このプラットフォームではFiles APIへのアップロードはサポートされていません。APIYIはFiles APIをサポートしていますか？を参照してください。
すべての出力画像には、SynthIDの不可視デジタルウォーターマーク（GoogleのAI生成コンテンツ識別技術）が付与されます。肉眼では見えず、使用にも影響しません。
エラーの全文は次のようになります。
このエラーは通常、画像アップロードのサイズが大きすぎるために発生します。リクエスト本文が大きくなりすぎて、接続が切断されます。次のベストプラクティスに従ってください。
  • 画像の枚数を制限する: 公式ルール（promptあたり最大14枚）の範囲内に収め、参照画像を詰め込みすぎないでください。
  • 画像1枚あたりのサイズを制限する: 各画像を5MB未満にしてください。公式の画像1枚あたりの上限は7MBですが、base64エンコードによってサイズが約3分の1増加するため、余裕を持たせてください。
  • アップロード前にフロントエンドで圧縮する: APIに送信する前に、フロントエンド（またはサーバー側のリレー）で画像を圧縮してください。一般的には、長辺の上限を設定し、JPEG/WebPに変換して、品質パラメーターを調整します。
  • URL入力に切り替える: Geminiネイティブ形式ではfileData.fileUriを使って画像URLを渡せるため、大きすぎるbase64リクエスト本文を完全に回避できます。Nano Banana開発ガイドを参照してください。

​
関連ドキュメント

Nano Banana 2 は現在 Preview ステータスです。機能と価格は調整される場合があります。最新情報についてはドキュメントの更新をご確認ください。