Skip to main content

​
概要

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 はわずか $0.025/image から！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は同期式です。ポーリングするタスクIDはなく、クライアントが切断されると、リクエストは課金されたままですが結果は失われます。このモデルでは十分に長いタイムアウトを設定してください。Image API の基本とベストプラクティス をご参照ください。

テキストから画像へのAPI

テキスト prompt から画像を生成します。オンラインテスト用の対話型プレイグラウンドが含まれます。

画像編集API

画像と編集指示をアップロードして、新しい画像を生成します。対話型プレイグラウンドが含まれます。

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

Codex / Claude Code / Cursor を使っている場合は、下のプロンプトをコピーしてエージェントに渡してください。まずこのページのプレーンテキスト版を取得し（任意の docs URL の末尾に .md を付けます）、その後はあなたのプロジェクト独自のスタックに合わせてコードを書きます。タイムアウト、防御的な parts パース、アップロード圧縮、解像度パラメータは、すでに要件に織り込まれています。

コーディングエージェントに Nano Banana 2 のテキストから画像生成と画像編集を統合またはトラブルシューティングさせます。Codex、Claude Code、Cursor などのツールにコピー＆ペーストしてください。

​
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/image、Proレベルの品質 + Flash級の速度）
  • 🎨 究極の品質 → Nano Banana Pro（$0.09/image、最高の忠実度）
  • ⚡ 最安 → Nano Banana（$0.025/image、高速で安定）

​
価格

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

​
呼び出しごとの課金

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

​
token ベース課金（Nano Banana 2 専用）

​
token ベース課金の価格見積もり

💰 token ベース課金の方がさらにお得です！ token ベース課金なら、512px の画像はわずか $0.025 です。Google の価格のわずか 36% にすぎません！低解像度のユースケースでは、これは呼び出しごとの課金（$0.055/画像）よりずっと安価です。4K では、token ベースの価格（約 $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-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 から、対して $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 呼び出しでは、-4k サフィックスなしの汎用モデル名 gemini-3.1-flash-image-preview を、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 画像検索から視覚的コンテキストを取り込み、実世界の対象によりよく一致する画像を生成します。たとえば、実在するランドマークの画像を生成する場合、検索結果を参照して精度を向上できます。
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（高同時実行数によるスロットリング）を受ける場合は、トークンのフォールバックグループとして NanoBananaEnterprise を追加してください（上記の「グループ設定」を参照）。主要グループが飽和した際に自動でフォールバックするため、高同時実行数下での成功率がさらに向上します。
image/png と image/jpeg 形式に対応しています。base64 エンコードまたは Files API 経由でアップロードできます。
すべての出力画像には SynthID の不可視デジタル透かし（Google の AI 生成コンテンツ識別技術）が付与されます。肉眼では見えず、利用にも影響しません。
完全なエラーは次のとおりです:
これは 通常、画像アップロードのサイズが大きすぎることが原因です。リクエストボディが大きくなりすぎて、接続が切断されます。次のベストプラクティスに従ってください:
  • 画像枚数を制限する: 公式ルールの範囲内（1 prompt あたり最大 14 枚）に収め、参照画像を詰め込みすぎないでください。
  • 画像ごとのサイズを制限する: 各画像は 5MB 未満にしてください。公式の1枚あたり上限は 7MB ですが、base64 エンコードでサイズが約 1/3 増えるため、余裕を持たせてください。
  • アップロード前にフロントエンドで圧縮する: API に送る前に、フロントエンド（またはサーバー側の中継）で画像を圧縮してください。一般的には、長辺を制限し、JPEG/WebP に変換し、quality パラメータを調整します。
  • URL 入力に切り替える: Gemini ネイティブ形式では、画像 URL を fileData.fileUri 経由で渡せるため、サイズが大きすぎる base64 リクエストボディを完全に回避できます。詳細は Nano Banana 開発ガイド をご覧ください。

​
関連ドキュメント

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