モデルを比較する
- 元のモデル
gemini-2.5-flash-imageは、ファミリー名と混同しないよう、このサイトではStandardと呼びます。生成のガイドは本ページ下部の「Nano Banana Standard」、編集のガイドはNano Bananaの画像編集(Standard)です。新しい4モデルには、それぞれ専用のガイドがあります。 - どのモデルも、
https://api.laozhang.aiで2つのリクエスト形式に対応しています。1つはOpenAI互換のchat completionsで、画像はレスポンスのテキスト内にBase64で入って返ります。もう1つはGeminiネイティブのgenerateContentで、アスペクト比と出力サイズも指定できます。詳しくは、後述の「プロトコルを選ぶ」を参照してください。 - 料金は2026年10月7日時点のLaoZhang APIの公開価格です。最新の一覧はモデルと料金を参照してください。
- 同じプロンプトで2K、16:9のリクエストを1回ずつ送ったところ、2026年10月14日の所要時間は、Nano Banana 2.1が25秒、Nano Banana 2が21秒、Nano Banana Proが69秒でした。並べた作例は、Nano Banana 2.1のガイドにあります。
- この一覧の後ろの表に、10種のアスペクト比と、Nano Banana 2.1と2で追加される4種を載せています。
- OpenAI互換ルートでは、アスペクト比もサイズも指定できません。テキストだけのプロンプトを送ると、Standardは1024×1024の画像を返し、Nano Banana 2.1はモデルが選んだフレームの1K画像を、それ以外のモデルは1Kの1:1画像を返します。
- 表の「—」は、GoogleがStandardの機能として記載していないことを示します。機能の情報は、GoogleのNano Banana画像生成ガイドに基づいています。
新規の用途は、2026年10月にNano Banana 2を更新したNano Banana 2.1から始めるのが基本です。512px出力が必要なときだけNano Banana 2を使います。解像度よりコストと速度を優先するなら2 Lite、レイアウト、文字、ブランドの細部を正確に出したいならProを選んでください。Nano Bananaとほかの画像モデルの比較は、画像APIの比較を参照してください。
5モデルに共通する点は次のとおりです。
- Googleの公式チャネルのモデルで、必要なのはLaoZhang APIのキーだけです。Googleアカウントは要りません。
- 回数課金のルートは固定料金です。出力サイズ、思考レベル、参照画像の数、生成か編集かで料金は変わらないため、2Kと4Kの画像は、Googleのトークン課金より低くなります。
- 1回のリクエストで返る画像は1枚です。複数枚が必要なときは、リクエストを複数回送ります。
- プラットフォーム側の同時実行数の上限や速度制限はありません。
429は上流の処理能力に由来します。詳しくは同時実行と429エラーを参照してください。 - 上流の200以外の応答(400、429、5xx)は課金されません。HTTP 200で画像がない場合は1回分が課金されます。3つのモデルファミリーの違いは、課金と失敗時の扱いで比べています。

Nano Banana 2.1、2K。プロンプト:Generate an image of a corner cafe after rain at dusk, warm light on the wet pavement, with a neon sign that reads "BANANA CAFE".

Nano Banana 2、2K

Nano Banana Pro、4K。プロンプト:Generate an image of a futuristic city skyline at sunset, highly detailed, with the words "NEO TOKYO" in a clean sans-serif font on a billboard.

Nano Banana 2 Lite、1K
プロトコルを選ぶ
どちらのエンドポイントも、APIキーとモデルIDは共通です。
OpenAI互換は、すでにOpenAI SDKを使っているアプリに向いています。画像はBase64として
choices[0].message.content に入って返り、多くは  のようなMarkdownの画像形式です。形式はPNGと決めつけず、データURLから読み取ってください。入力の image_url には、ローカルファイルから作ったデータURLか、公開されているHTTPSのURLを指定できます。
Geminiネイティブでは、すべての画像オプションを指定できます。オプションは generationConfig.imageConfig に入れます。
aspectRatio:モデルごとの一覧にある値を指定します。imageSize:Kを大文字にしたサイズを指定します。各モデルが受け付ける値は、次の表のとおりです。
レスポンスでは、各画像が
mimeType とBase64の data を持つ inlineData パートとして並びます。Google Gen AI SDKでこのエンドポイントを呼び出すときのベースURLは、Geminiプロトコルを参照してください。
課金
LaoZhang APIのNano Bananaは回数課金のみです。出力サイズ、思考レベル、参照画像の数、生成か編集かにかかわらず、モデルごとに料金は1つです。別料金がかかるのは、Google検索グラウンディングだけで、後述のとおり検索1回ごとに課金します。 Googleはトークンで課金するため、画像が大きいほど、思考トークンが多いほど料金が上がります。次の表は、2026年10月7日時点のLaoZhang APIの公開価格と、Googleの価格を比べたものです。
Googleの数値は、標準の有料料金を出力画像1枚あたりに換算したもので、2026年10月13日に確認しています。Googleは入力トークンと思考トークンも課金します。
Googleの課金では、4K出力や思考レベル
high を使うと1回あたりの料金が上がります。LaoZhang APIでは1回あたりの料金が変わらないので、解像度が高いほど差が広がります。たとえば、Nano Banana 2の4K画像は、Googleの標準価格より約64%低くなります。
Nano Bananaには回数単価しかないため、APIキーの課金方式は従量優先(按量优先、推奨)または回数課金(按次计费)にしてください。従量優先のキーは、回数課金と従量課金の両方のモデルを呼び出せます。
従量課金(按量计费)のキーは従量課金のモデルしか呼び出せないので、Nano Bananaは使えません。課金方式の違いは、課金と料金を参照してください。
各リクエストのステータスと課金額は、呼び出しログで確認できます。
- HTTP 200で画像がない場合:1回分を課金します。 上流からHTTP 200が返れば、生成でも編集でも、完了した1回の呼び出しとして扱います。LaoZhang APIはプロンプトや出力の内容を審査しないため、画像が返ったかどうかでは課金を分けません。後述の「空のレスポンスで課金されないようにする」を参照してください。
- クライアントのタイムアウト: サーバー側で画像の生成が完了し、課金される場合があります。再送する前に呼び出しログを確認し、二重に支払わないようにしてください。
- 上流の200以外の応答: 生成に至らなかった400、429、503などの応答は課金されません。
- Google検索グラウンディング:1回の呼び出し料金に加えて、検索1回につき$0.014。 これはGoogleの1,000回あたり$14と同じ単価で、Nano Banana 2.1、Nano Banana 2、Nano Banana Proに適用されます。
- 検索を何回行うかはモデルが決めるため、同じプロンプトでも回数が変わることがあります。呼び出しログに、リクエストごとの検索回数と課金額が表示されます。
- たとえば、Nano Banana 2.1で2回検索したリクエストは、$0.045 + 2 × $0.014 = $0.073です。
空のレスポンスで課金されないようにする
HTTP 200で画像がない場合は、多くが次のどちらかが原因です。- プロンプトが画像を求めていない。 欲しい内容を説明しているだけで、「画像を生成して」や「編集した画像を返して」と指示していないと、モデルが考えるだけで、テキストを返したり何も返さなかったりすることがあります。
- 上流の安全フィルターでブロックされた。 プロンプトや参照画像に、著作権のあるキャラクター、機微な人物、センシティブな内容が含まれると、Googleは画像もエラーコードも返しません。同じ内容を再送しても、ほとんどの場合ブロックされ、そのたびに課金されます。
- 性的、暴力的、残酷、憎悪を含む内容。際どい暗示的な内容も含みます
- 画像からの透かしの除去
- ディズニー、マーベル、任天堂のキャラクターなど、有名な著作物のキャラクター
- 未成年者に関する不適切な内容
- 著名人や政治家などの公人
- 注文のスクリーンショット、領収書、値札など、金額に関する情報の編集
- 実在の人物の服装の変更や顔の入れ替え
- どのプロンプトでも、画像を求めることを明示する。
- 送信する前に、プロンプトと参照画像を自分で確認し、安全フィルターに引っかかりそうな内容を取り除く。
candidatesがないレスポンスや、inlineDataパートがないレスポンスは、「画像なし」として扱う。candidatesがある場合は、finishReasonと返ってきたテキストから理由を確認する。- 空のレスポンスを自動で再試行しない。先にプロンプトや参照画像を変更する。バックオフ付きの再試行は、429と5xxのエラーに限る。
セットアップ
1
APIキーを作成する
トークン管理でトークンの作成ダイアログ(创建令牌)を開き、課金方式(计费模式)を従量優先(按量优先、推奨)または回数課金(按次计费)にして、作成(创建)をクリックします。
default グループには、5つのNano Bananaモデルがすべて含まれています。
2
キーを環境変数に保存する
3
依存パッケージをインストールする
jq も必要です。たとえば、brew install jq や sudo apt-get install jq でインストールします。Pythonヘルパー
次のモジュールをnano_banana.py として保存します。2つのルートの認証、ローカルファイルの画像入力への変換、返ってきたすべての画像の保存(バイト列に合わせた拡張子:PNG、JPEG、WebP)を行います。
python nano_banana.py response.json output-name を実行すると、レスポンスファイルの画像を保存できます。
- 1枚目は
output-name.png(または.jpg、.webp)として書き出されます。 - 2枚目以降は、
output-name-2、output-name-3のように連番が付きます。
Nano Banana Standard
gemini-2.5-flash-image は、元のNano Bananaモデルです。出力は約1Kで、OpenAI互換ルートにテキストだけのプロンプトを送ると1024×1024が返ります。Geminiネイティブのルートでは、前述の10種のアスペクト比を指定できます(たとえば16:9なら1344×768)。編集では、Googleによると、入力画像は3枚までが最も安定します。
画像を生成する
次の例は、前述の「Pythonヘルパー」を使います。- Python
- cURL
standard-fox.png、.jpg、.webp のいずれかで保存されます。画像を求めることを明示してください。質問のような文面のプロンプトでは、テキストだけの回答になることがあります。
1:1以外の比率にしたいときは、Geminiネイティブのエンドポイントを呼び出し、aspectRatio を指定して imageSize は指定しません。
画像を編集する
指示と画像を1つのユーザーメッセージに入れて送ります。to_data_url は、ローカルファイルを、MIMEタイプが合ったデータURLに変換します。
新しいモデルに移行する
リクエストの形式はNano Bananaのモデル間で共通なので、移行は主にmodel を変えるだけです。
gemini-3.1-flash-lite-image(Nano Banana 2 Lite):1K出力と10種のアスペクト比はそのままです。gemini-nano-banana-2.1(Nano Banana 2.1):1Kから4Kの出力、14種のアスペクト比、最大14枚の参照画像が加わり、料金はNano Banana 2より低くなります。gemini-3.1-flash-image(Nano Banana 2):512pxから4Kの出力、14種のアスペクト比、最大14枚の参照画像が加わります。
imageSize も指定できるようになります。
大きな画像と画像URL
Base64でエンコードした画像を含め、リクエスト本文全体を20 MB以内に収めてください。それより大きな参照画像は、fileData でURLとして渡します。 Base64にするとファイルサイズが約3分の1増えるため、inlineData で送る画像は合計で約15 MB以下にします。
Geminiネイティブのルートでは、fileData パートと inlineData パートを同じ parts 配列に混在させられます。並べた順に、1枚目、2枚目、…の参照画像として数えられます。次のリクエスト本文は、人物の写真をURLで、ジャケットをBase64で送る例です。
- ログイン、Cookie、Refererが不要な、HTTPSの直リンクであること。CAPTCHA、Cloudflareのチャレンジ、User-Agentによるフィルターの背後にないこと。
- サイトの
robots.txtが、画像のパスへのクローラーのアクセスをブロックしていないこと。 - 署名付きURLの場合は、キューの待ち時間と再試行をカバーできる期間、有効であること。30分以上を目安にしてください。
mimeTypeが実際の形式と一致していること。JPEGはimage/jpeg、PNGはimage/png、WebPはimage/webpです。
Cannot fetch content from the provided URL を伴う400を返し、課金されません。OpenAI互換のルートでも、同じ条件で image_url.url に公開画像のURLを指定できます。
トラブルシューティング
Cannot fetch content from the provided URLを伴うHTTP 400。 サーバーがfileDataの画像をダウンロードできませんでした。前述の「大きな画像と画像URL」の条件を順に確認してください。- HTTP 413。 リクエスト本文が大きすぎます。大きな画像は
fileDataでURLとして渡すか、リクエスト全体が20 MB以内になるよう縮小してください。 - HTTP 200だが画像がない。 OpenAI互換の応答にテキストしかないか、ネイティブの応答に
inlineDataパートがありません。すでに課金されているので、同じリクエストをそのまま再送せず、画像を求めることを明示するか、制限される内容を取り除いてください。詳しくは、前述の「空のレスポンスで課金されないようにする」を参照してください。- ネイティブの応答では、
finishReasonと、含まれていればpromptFeedbackを確認します。 - 値の例として、
IMAGE_SAFETY、IMAGE_PROHIBITED_CONTENT、NO_IMAGEがあります。
- ネイティブの応答では、
- HTTP 401。 APIキーと
Authorization: Bearerヘッダーを確認してください。アカウントのAccessTokenではなく、トークン管理で作成したモデル用のAPIキーを使います。 - HTTP 400。 モデルID、JSON本文、
aspectRatioとimageSizeがそのモデルの一覧にある値かを確認してください。Kは大文字にします。2kのように小文字のサイズを拒否するモデルもあります。 - HTTP 429、5xx、タイムアウト。 指数バックオフで再試行してください。タイムアウトしたあとは、再送する前に呼び出しログでリクエストを探し、同じ画像に二重に支払わないようにします。
よくある質問
Nano BananaのAPIキーを取得するには?
LaoZhang APIに登録し、トークン管理でトークンを作成します。グループはdefault、課金方式は従量優先(推奨)または回数課金を選んでください。表示される sk- で始まる文字列が、5つのNano Bananaモデルすべてで使えるAPIキーです。Googleアカウントも、Gemini APIのキーも必要ありません。
チャージしたら、前述の「Pythonヘルパー」で最初のリクエストを送り、各リクエストの課金額を呼び出しログで確認します。
Googleアカウントなしで使えますか?
使えます。必要なのはLaoZhang APIのキーだけで、Google Cloudのプロジェクト、Gemini APIのキー、Googleアカウントのいずれも不要です。5モデルとも、Googleの公式チャネルのモデルで、Googleのネイティブ形式と同じリクエストで呼び出せ、回数課金です。どのNano Bananaモデルから始めるべき?
Nano Banana 2.1(gemini-nano-banana-2.1)から始めてください。Nano Banana 2のテキストとレイアウトを改善したモデルで、1Kから4Kの出力と最大14枚の参照画像に対応し、1回あたりの料金はより低くなっています。512px出力が必要ならNano Banana 2、大量の1K画像ならNano Banana 2 Lite、複雑なレイアウトやブランド要件の厳しい素材ならNano Banana Proを使います。
新規の用途にStandardは使わないでください。Googleが非推奨にしており、停止日が一致しておらず(非推奨のページでは2027年3月15日、料金のページでは2026年10月2日)、いつ停止してもおかしくないためです。
すでに使っている場合は、1枚の画像を編集する1Kの用途はNano Banana 2 Liteへ、複数画像の合成はNano Banana 2.1かNano Banana 2へ移行してください。リクエストは同じ形式のまま使えます。詳しくはNano Banana 2への移行を参照してください。
OpenAI互換ルートで4Kは出せますか?
出せません。Chat completionsのリクエストには、アスペクト比やサイズを指定するフィールドがないためです。同じプロンプトを、aspectRatio と imageSize を付けて、Geminiネイティブのエンドポイントに送ってください。
出力サイズや参照画像で料金は変わりますか?
変わりません。モデルごとに1回あたりの料金は1つです。512pxでも4Kでも、思考レベルが既定でもhigh でも、参照画像が1枚でも14枚でも、生成でも編集でも同じです。別料金になるのは、Google検索グラウンディングの検索1回あたり$0.014だけです。Googleの料金との比較は、前述の「課金」を参照してください。
失敗、タイムアウト、画像なしでも課金される?
画像がないHTTP 200は1回分が課金されます。プロンプトが画像を求めていなかった場合や、上流の安全フィルターでブロックされた場合も同じです。クライアントのタイムアウトも課金される場合がありますが、429や503などの200以外の上流応答は課金されません。 各リクエストのステータスと課金額は呼び出しログにあります。ケースごとの対処は、前述の「課金」で説明しています。1回のリクエストで複数枚を得られますか?
期待しないでください。Googleは、プロンプトで求めた枚数をモデルが必ず返すとは限らないとしています。複数枚が必要なら、リクエストを複数回送ってください。1回につき1回分が課金されます。 ただし、1つのレスポンスに複数の画像が入ることはあります。Gemini 3の画像モデルは、思考中に構図を試すための途中の画像を作り、それが結果と一緒に返ることがあります。最後の画像が最終結果です。Pythonヘルパーはすべての画像を順に保存するので、番号が最大のファイルが最後の画像です。プロンプトに向いている言語は?
Googleは、最も性能が高いプロンプト言語として、英語と、ほかの14のロケールを挙げています。中国語(zh-CN)、日本語、韓国語、スペイン語、ドイツ語、フランス語などが含まれます。それ以外の言語でも動作しますが、結果の一貫性が下がる場合があります。生成画像に透かしは入りますか?
入ります。Googleによると、Nano Bananaモデルが生成するすべての画像にSynthIDの透かしが含まれます。SynthIDは画像に埋め込まれていて、人の目には見えませんが、ツールで画像がAI生成かどうかを識別できます。入力できる画像形式は?
Googleは、対応する画像形式として、PNG、JPEG、WebP、HEIC、HEIFを挙げています。このサイトの例とPythonヘルパーが扱えるのはPNG、JPEG、WebPなので、HEICやHEIFの写真は先にJPEGに変換してください。形式にかかわらず、mimeType かデータURLのプレフィックスは、ファイルの実際の形式と一致させます。
Base64にするとファイルが約3分の1大きくなるため、非常に大きな写真は、送る前に縮小してください。リクエスト本文が20 MBを超えそうなときは、画像をURLで渡します。前述の「大きな画像と画像URL」を参照してください。
真っ白な背景に黒い斑点が出るのはなぜ?
Nano BananaはGoogleのAI Studioのルートで動いており、広い範囲の真っ白な部分に、黒い斑点、にじみ、グレーのもや、色かぶりが出ることがあります。混雑する時間帯に多くなります。代わりに、明るい別の色の背景を指定してください。- ライトグレー:
light gray background, #F5F5F5 - ベージュ:
beige background, #F5F0E5 - ライトブルー:
light blue background, #E8F0F8
参考資料と関連ページ
- Google: Nano Banana image generation — モデル名、出力サイズ、アスペクト比、参照画像の上限、思考、グラウンディング、対応言語、SynthID
- Google: image understanding — 対応している入力画像の形式
- Google: Gemini API pricing — Googleの画像モデルの料金と検索グラウンディングの料金
- Google: generateContent reference —
imageConfigのフィールドとimageSizeの値 - Google: Gemini API deprecations — 上流のモデルの停止日
- Nano Bananaの画像編集(Standard)とNano Banana Proの画像編集 — 編集の完全なガイド
- モデルと料金 — LaoZhang APIの最新の価格とグループ
- 呼び出しログ — リクエストのステータスと課金額の確認
- GeminiプロトコルとOpenAIプロトコル — 各ルートのクライアント設定
- 画像APIの比較 — Nano Bananaと、GPT Image 2.5、FLUX.2、Seedreamの比較