🔥 最新リリース: Google が Nano Banana 2（
gemini-3.1-flash-image-preview）を2026年2月26日にリリースしました — Pro級の品質を Flash級の速度で、従量課金で最安 $0.025/枚！Nano Banana 2 のドキュメントを見る🆕 2026年5月29日更新（
-preview は廃止）: Google は公式ドキュメントを更新し、安定版モデル名 gemini-3-pro-image（-preview なし）をリリースしました。APIYI はすでに対応しています。- 旧名も引き続き使えます:
gemini-3-pro-image-previewはこれまでどおり使え、料金は変わらず、コード変更も不要です。 - どちらの名前でも使えます: 新しい
gemini-3-pro-image名でも、元の-preview名でも使えます。
すべての image API は同期式です — ポーリングする task ID はなく、クライアントが切断されると、リクエストは課金されたままでも結果は失われます。このモデルには十分なタイムアウトを設定してください。Image API の基本とベストプラクティス を参照してください。
最新バージョン
- Nano Banana 2:
gemini-3.1-flash-image-preview（🔥 2026年2月26日リリース）— 詳細を見る - Nano Banana Pro:
gemini-3-pro-image-preview（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 エージェントに統合を任せる
Codex / Claude Code / Cursor で構築しているなら、下の prompt をコピーしてエージェントに渡してください。エージェントはまずこのページのプレーンテキスト版を取得し（任意の docs URL に
.md を付けます）、その後はあなたのプロジェクト固有のスタックでコードを書きます。つまり、タイムアウト、防御的な parts パース、アップロード圧縮、解像度パラメータは、すでに要件に組み込まれています。Codex、Claude Code、Cursor などのツールに貼り付けて使えるよう、コーディングエージェントに Nano Banana Pro のテキストから画像生成と画像編集の統合・トラブルシュートを任せてください。
この prompt が防ぐこと
この prompt が防ぐこと
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から本番までエンドツーエンドでサポートします。
Calling Method
Google のネイティブな Gemini API 形式を使用します:Unsupported Features
価格比較
グループ設定
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)
互換性の注意
以前に以下のモデルを使用していた場合は、モデル名をそのまま置き換えるだけでOKです。最新バージョンにアップグレード
- 旧バージョンの任意のもの →
gemini-3-pro-image-preview(🔥 推奨, 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-preview）:- Pro級の品質 + Flash級の速度
- 従量課金は最安 $0.025/image
- 14種類のアスペクト比（Pro より4種類多い）
- 独自機能: thinking モード、Image Search Grounding
gemini-3-pro-image-preview）:- 最高の忠実度
- $0.09/request
Pro版とレガシー版のどちらを選ぶべきですか？
Pro版とレガシー版のどちらを選ぶべきですか？
新規プロジェクトには Nano Banana Pro を推奨します（
gemini-3-pro-image-preview）✅ Pro版の利点:- 4K 超高解像度（1K、2K、4K）に対応
- 業界最先端のテキストレンダリング品質
- 高度なローカル編集機能
- 公式料金の約38〜67%のみ
gemini-2.5-flash-image）は次の用途に適しています:- コスト重視のシナリオ（約 $0.025/image 対 $0.09/image）
- 高速生成が必要な場合（10秒対20秒）
- 既存プロジェクトの移行
他の画像モデルから Nano Banana に切り替えるには？
他の画像モデルから Nano Banana に切り替えるには？
モデル名を
gpt-4o-image または sora_image から gemini-3-pro-image-preview（推奨の Pro）または gemini-2.5-flash-image（レガシー）に変更するだけで、他のパラメータはそのままです。生成された画像の形式は何ですか？
生成された画像の形式は何ですか？
モデルは base64 エンコードされた画像データを返し、通常は PNG または JPEG 形式です。コードが形式を自動検出し、対応するファイル形式で保存します。
画像編集機能はサポートしていますか？
画像編集機能はサポートしていますか？
はい、Nano Banana Pro は画像生成と編集の両方に対応しています。Image Editing API Reference をご覧ください。
connection reset by peer / write_response_body_failed (500) が発生するのはなぜですか？
connection reset by peer / write_response_body_failed (500) が発生するのはなぜですか？
完全なエラーは次のとおりです:これは通常、画像アップロードが大きすぎることが原因です。リクエスト本文が大きくなりすぎて、接続が切れてしまいます。 次のベストプラクティスに従ってください:
- 画像枚数を制限する: 公式ルール内（1 prompt あたり最大14枚）に収め、参照画像を詰め込みすぎないでください。
- 画像1枚あたりのサイズを制限する: 各画像を5MB未満に抑えてください。公式の1枚あたり上限は7MBですが、base64 エンコードでサイズは約1/3増えるため、余裕を持たせてください。
- アップロード前にフロントエンドで圧縮する: API に送る前に、フロントエンド（またはサーバー側リレー）で画像を圧縮してください。一般的には、長辺を制限し、JPEG/WebP に変換し、quality パラメータを調整します。
- URL 入力に切り替える: Gemini のネイティブ形式では
fileData.fileUri経由で画像 URL を渡せるため、巨大な base64 のリクエスト本文を完全に回避できます。詳しくは Nano Banana Dev Guide をご覧ください。