🔥 最新リリース: Googleは2026年2月26日にNano Banana 2（
gemini-3.1-flash-image）をリリースしました — Proレベルの品質とFlashクラスの速度を実現し、従量課金で画像あたりわずか$0.025からご利用いただけます！Nano Banana 2のドキュメントを見る🆕 2026年5月29日更新（
-previewがリリースされました）: Googleは公式ドキュメントを更新し、安定版のモデル名 gemini-3-pro-image（-previewなし）をリリースしました。APIYIではすでに対応しています。- このドキュメントでは、以降すべて安定版の名称
gemini-3-pro-imageを使用しています — 新しい連携にはこの名称をご利用ください。 - 旧名称も引き続き使用できます:
gemini-3-pro-image-previewはこれまでどおり動作し、料金も変更ありません。コードの変更も不要です。
すべての画像APIは同期処理です — ポーリングするタスクIDはなく、クライアントが切断されると、リクエストの課金は継続したまま結果が失われます。このモデルでは十分に長いタイムアウトを設定してください。画像APIの基本とベストプラクティスをご覧ください。
最新バージョン
- Nano Banana 2.1:
gemini-nano-banana-2.1（🆕 2026年10月6日リリース。Nano Banana 2のアップグレード版） — 詳細を見る - Nano Banana 2:
gemini-3.1-flash-image（🔥 2026年2月26日リリース） — 詳細を見る - Nano Banana Pro:
gemini-3-pro-image（2025年11月20日リリース）
以前のバージョン
- 公式リリース版:
gemini-2.5-flash-image（安定版、10種類のアスペクト比に対応） - プレビュー版:
gemini-2.5-flash-image-preview（⚠️ 2025年10月30日に提供終了）
主な特長
-
🔥 Nano Banana Proの新機能:
- 🎯 4K高解像度対応: 1K、2K、4Kの3種類の解像度に対応し、最大4096×4096
- 📝 テキスト描画の王者: 画像内のテキストが鮮明で読みやすく、ポスターや広告に最適
- ✨ 部分編集: カメラアングル、フォーカス、カラーグレーディング、シーンのライティング調整に対応
- 🧠 高度な推論: Gemini 3 Proをベースとしており、複雑なpromptをより適切に理解
-
🚀 共通のメリット:
- ⚡ 生成速度: Nano Banana Proは約20秒、以前のバージョンは約10秒
- 💰 お手頃な料金: チャージボーナスと組み合わせることで、非常に高いコストパフォーマンスを実現
- 🔄 完全な互換性: Google公式のGemini APIフォーマットと完全に互換
- 🎨 Googleの技術: Googleの最新かつ最先端の画像生成・編集技術を採用
インタラクティブな API テスト
テキストから画像 API
画像を生成するためのテキストプロンプトを入力すると、オンラインテスト用のインタラクティブな Playground が利用できます。
画像編集 API
画像と編集指示をアップロードして編集済み画像を生成すると、オンラインテスト用のインタラクティブな Playground が利用できます。
AI エージェントに統合を任せる
この prompt をコピーして Codex / Claude Code / Cursor に貼り付けてください
このプロンプトは、まず本ページのプレーンテキスト版を取得し（任意のドキュメント URL に .md を追加）、その後お使いのプロジェクトのスタックでコードを記述します。タイムアウト、防御的な parts パース、アップロード時の圧縮、解像度パラメータはあらかじめ要件に組み込まれています。
このプロジェクトに Nano Banana Pro（
gemini-3-pro-image）のテキストからの画像生成および画像編集を統合 / トラブルシューティングしてください。コードに触れる前にドキュメントを読んでください: このページのプレーンテキスト版を取得するには https://docs.apiyi.com/en/api-capabilities/nano-banana-image/overview.md を取得してください。より詳細なパラメータについては、
.mdを追加して…
- タイムアウト:
POST https://api.apiyi.com/v1beta/models/gemini-3-pro-image:generateContentの Gemini ネイティブフォーマットを呼び出します。クライアントのタイムアウトは解像度ごとに設定し…
全7つの要件があります。以下のボタンを使用して、プロンプト全文をコピーしてください。
このプロンプトによって回避できる落とし穴
このプロンプトによって回避できる落とし穴
APIYIのNano Banana Proが選ばれる理由
Nano Banana Pro / 2 は、APIYIで利用量第1位のモデルです — 安定性が高く、信頼できて、高速です。プロフェッショナルなチームと仕事をしたいなら、APIYIが最適です。 Googleのフラッグシップで、厳格なコンテンツ安全性制御を備え、APIYIが信頼性、コスト、統合の面で最適化しています：公式チャネル · Geminiと同じ
Googleのネイティブ Gemini API（
/v1beta/models/.../generateContent）と OpenAI SDK パターンに100%互換です — リクエストボディ、レスポンスフィールド、エラーコードも同じです。コード変更なしで移行できます。同時実行数制限なし
Google AI StudioのRPM/RPD上限に縛られません。エンタープライズ規模のバッチ生成やピークトラフィックでも、クォータ中断なしで線形にスケールします。
Googleの定価の31-38%
1回あたり $0.09/image（Google 4K の $0.24 と比較）。チャージボーナスと組み合わせると、定価の31.25%まで下がり、4Kでは最大68.75%お得です。
グローバルなゼロ障壁アクセス
海外サーバーやプロキシは不要 — 本土のデータセンター、家庭用ネットワーク、または海外ノードから
api.apiyi.com に直接接続できます。安定したレイテンシで、越境向けの再設計は不要です。モデルラインナップ全体
同シリーズで Nano Banana 2（最高のコスパ + Flash並みの速度）、Nano Banana Pro（究極の品質）、そして従来の Nano Banana をカバーします — シーンに応じて使い分けできます。
プロフェッショナルなエンタープライズサポート
当チームは本番環境での画像生成導入を専門としており、モデル選定、チューニング、統合に深い経験があります — PoCから本番までエンドツーエンドでサポートします。
呼び出し方法
Google のネイティブ Gemini API 形式を使用します:非対応機能
価格比較
グループ設定
APIYI では Nano Banana Pro に 2 つのグループが用意されています。ダッシュボード → Token 設定 で切り替えます:
なぜ 1.4x なのですか? 1.4x でも価格は Google の定価の約 50% にとどまり、公式価格より大幅に安いです。これは高い同時実行数のワークロードや予期しない上流側のリスク制御イベントに備えたフォールバックレーンで、エンタープライズ顧客向けに高可用性を保証します。デフォルトグループが逼迫したら、Token を
NanoBananaEnterprise に切り替えて急増をやり過ごします。
推奨の課金モデル: Pay-as-you-go Priority を選んでください — Nano Banana Pro の per-call 課金と Nano Banana 2 の token ベース課金の両方に対応し、シリーズ全体で 1 つの Token です。
Token settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)
互換性に関する注意事項
以下のモデルを以前に使用していた場合は、モデル名を置き換えるだけで使用できます。最新バージョンにアップグレード
- 古いバージョン →
gemini-3-pro-image（🔥 おすすめ、Nano Banana Pro）- 4K高解像度出力に対応
- 最も優れたテキスト描画機能
- ローカル編集機能
安定版を使用
gpt-4o-image→gemini-2.5-flash-imagesora_image→gemini-2.5-flash-image- 旧Nano Banana →
gemini-2.5-flash-image
対応解像度とアスペクト比
出力解像度
Nano Banana Pro は 3 つの解像度ティアをサポートしています — 1K、2K、4K（512px ティアは Nano Banana 2 限定です）:アスペクト比ごとの出力サイズ（ピクセル）
下の表は、1K / 2K / 4K の解像度ティア全体における、10 種類すべてのアスペクト比に対する Nano Banana Pro の実際の出力サイズを示しています（ソース: Google 公式ドキュメント）。リクエストでは、比率にはaspect_ratio を、ティアには image_size（または resolution）を設定してください:
1:4、4:1、1:8、8:1 の超縦長/超横長比率、または 512px の低解像度ティアが必要な場合は、Nano Banana 2 を使用してください（14 種類のアスペクト比 + 512px）。よくある質問
Nano Banana 2とProのどちらを選べばよいですか？
Nano Banana 2とProのどちらを選べばよいですか？
コストパフォーマンスを重視する場合は、Nano Banana 2（
gemini-3.1-flash-image）をお選びください。- Proレベルの品質とFlashクラスの速度
- 従量課金で、1画像あたりわずか$0.025から利用可能
- 14種類のアスペクト比（Proより4種類多い）
- 独自機能：思考モード、画像検索グラウンディング
gemini-3-pro-image）をお選びください。- 最高レベルの忠実度
- 1リクエストあたり$0.09
Pro版とレガシー版のどちらを選べばよいですか？
Pro版とレガシー版のどちらを選べばよいですか？
新しいプロジェクトにはNano Banana Proをおすすめします（
gemini-3-pro-image）。✅ Pro版のメリット：- 4Kの超高解像度に対応（1K、2K、4K）
- 業界をリードするテキスト描画品質
- 高度なローカル編集機能
- 公式価格の約38～67%のみ
gemini-2.5-flash-image）は、次の用途に適しています。- 予算を重視する場合（約$0.025/画像、Proは$0.09/画像）
- 高速な生成が必要な場合（10秒対20秒）
- 既存プロジェクトを移行する場合
他の画像モデルからNano Bananaに切り替えるにはどうすればよいですか？
他の画像モデルからNano Bananaに切り替えるにはどうすればよいですか？
他のパラメーターはそのままにして、モデル名を
gpt-4o-imageまたはsora_imageからgemini-3-pro-image（おすすめのPro版）またはgemini-2.5-flash-image（レガシー版）に変更するだけです。生成される画像の形式は何ですか？
生成される画像の形式は何ですか？
モデルはbase64エンコードされた画像データを返します。通常、PNGまたはJPEG形式です。コードが形式を自動的に検出し、対応するファイル形式で保存します。
画像編集機能に対応していますか？
画像編集機能に対応していますか？
はい、Nano Banana Proは画像生成と画像編集の両方に対応しています。画像編集APIリファレンスをご覧ください。
connection reset by peer / write_response_body_failed (500)が発生するのはなぜですか？
connection reset by peer / write_response_body_failed (500)が発生するのはなぜですか？
エラー全文は次のようになります。多くの場合、画像のアップロードサイズが大きすぎることが原因です。リクエストボディが大きくなりすぎて、接続が切断されます。次のベストプラクティスに従ってください。
- 画像の枚数を制限する：公式ルールの範囲内（promptあたり最大14枚）に収め、参照画像を大量に追加しないでください。
- 1枚あたりのサイズを制限する：各画像を5MB未満にしてください。公式の1枚あたりの上限は7MBで、base64エンコードによってサイズが約1/3増えるため、余裕を持たせてください。
- アップロード前にフロントエンドで圧縮する：APIに送信する前に、フロントエンド（またはサーバー側のリレー）で画像を圧縮してください。一般的には、長辺の上限を設定し、JPEG/WebPに変換して、品質パラメーターを調整します。
- URL入力に切り替える：Geminiのネイティブ形式では、
fileData.fileUriを使って画像URLを渡せるため、大きなbase64リクエストボディを完全に回避できます。Nano Banana開発ガイドをご覧ください。