Nano Banana Pro API 2026：公式 Gemini ルート、料金、コード、provider 確認

Nano Banana Pro API は開発者が使う市場名であり、Google 公式の呼び方では Gemini 3 Pro Image に対応します。現在の公式 Pro 画像モデル ID は `gemini-3-pro-image` です。実装前に決めるべきことは、コードの書き方だけではありません。そのリクエストを Google Standard、Google Batch/Flex、provider gateway、またはより安い Nano Banana モデルのどれで運用するかです。

2026 年 7 月 1 日時点で確認した Google Standard の画像出力価格は、`1K/2K` が `0.134\`、\`4K\` が \`0.24` です。Batch/Flex は Google の first-party discount lane で、`0.067\` と \`0.12` まで下がりますが、処理は asynchronous または flexible になります。laozhang.ai の公開 docs には同日に `0.09/image\` と \`0.09/edit` が見えましたが、これは provider 価格であり、Google 公式価格ではありません。

まず次の表で route を分ける：

これらの事実は 2026 年 7 月 1 日に Google image-generation、pricing、API-key、billing、rate-limit docs と laozhang.ai の公開 Nano Banana Pro docs で確認しました。価格、alias、quota、provider billing は変わるため、launch 前には必ず公式 docs または provider console を再確認してください。

Nano Banana Pro API は今何を指すのか

Nano Banana Pro API は、Pro 画像能力を探す開発者の言い方です。公式実装では Gemini API の Gemini 3 Pro Image に対応し、現在の model string は `gemini-3-pro-image` です。古い `gemini-3-pro-image-preview` は migration note や provider compatibility note として扱い、現在の主 path には置かない方が安全です。

この違いは troubleshooting に直結します。画像生成 request には model owner、contract owner、operational owner があります。model owner は画像能力、contract owner は料金と failure rule、operational owner は project、key、quota、logs、status route を持ちます。この三つを一つのコード例に押し込むと、エラー時にどこを見るべきか分からなくなります。

早い検証なら AI Studio と Gemini API key で十分です。しかし production では billing project、key type、quota tier、retry、logs、cost records まで含めて route を設計します。Nano Banana Pro API の安全性は、model ID だけでは決まりません。

Pro が本当に必要かを先に決める

Nano Banana Pro は default model ではなく override model と考えるべきです。4K、複雑な layout、文字の fidelity、brand asset、final product visual が必要な時に `gemini-3-pro-image` を選びます。draft、探索、内部 thumbnail、多数の variant、単純な product scene なら、より安い Nano Banana model から始める方が自然です。

コスト削減は gateway 探しより model substitution で効くことが多いです。ideation と candidate generation は安い model、final render だけ Pro にすれば、finance にも product team にも説明しやすい構造になります。

公式料金：Standard と Batch/Flex を分けて見る

Google 公式価格は単独で読むべきです。provider 価格を同じ表に入れると、provider discount を Google discount と誤解しやすくなります。

重要なのは、Batch/Flex がなぜ安いかです。これは hidden coupon ではなく、処理 lane の変更です。user-facing な即時出力が必要なら Standard が自然です。offline、queued、periodic、batch generated な workload なら Batch/Flex を評価します。

さらに二つの caveat があります。確認時点の Google pricing page には `gemini-3-pro-image` の free image-output tier は見当たりませんでした。また grounding を使うと search-query charge が別に発生する場合があります。画像単価だけでは実コストを見落とします。

Key、billing、quota は project の境界で見る

AI Studio の API key は認証面です。billing と quota の全体設計ではありません。Google の current key docs では、新しい AI Studio key は auth key です。unrestricted standard key は 2026 年 6 月 19 日から拒否され、standard key は 2026 年 9 月に拒否されます。古いサンプルが動いたからといって、新しい production baseline にしてはいけません。

Quota 問題を API key の数で解決しようとしないでください。key rotation は security operation であって scaling plan ではありません。まず project/model live limits を見て、backoff、batching、concurrency reduction、Batch/Flex、official quota request の順に考えます。

Interactions API で最初の公式 request を送る

Google の current image docs は、最新機能と model には Interactions API を推奨しています。以下では `gemini-3-pro-image` を使います。`GEMINI_API_KEY` は environment variable に置きます。

Python

```python from google import genai import base64

client = genai.Client()

interaction = client.interactions.create( model="gemini-3-pro-image", input="Create a premium product hero image for a black mechanical keyboard on a clean studio background.", response_format={ "type": "image", "aspect_ratio": "16:9", "image_size": "2K", }, )

if interaction.output_image: with open("nano-banana-pro-output.png", "wb") as f: f.write(base64.b64decode(interaction.output_image.data)) ```

JavaScript

```javascript import { GoogleGenAI } from "@google/genai"; import * as fs from "node:fs";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const interaction = await ai.interactions.create({ model: "gemini-3-pro-image", input: "Create a premium product hero image for a black mechanical keyboard on a clean studio background.", response_format: { type: "image", aspect_ratio: "16:9", image_size: "2K", }, });

if (interaction.output_image) { fs.writeFileSync( "nano-banana-pro-output.png", Buffer.from(interaction.output_image.data, "base64"), ); } ```

REST

```bash curl -s -X POST
"https://generativelanguage.googleapis.com/v1beta/interactions"
-H "x-goog-api-key: $GEMINI_API_KEY"
-H "Content-Type: application/json"
-d '{ "model": "gemini-3-pro-image", "input": [ { "type": "text", "text": "Create a premium product hero image for a black mechanical keyboard on a clean studio background." } ], "response_format": { "type": "image", "aspect_ratio": "16:9", "image_size": "2K" } }' ```

既存 code がまだ `generateContent` を使っている場合は、model、endpoint、provider、image size、parser を同時に変えないでください。まず同じ contract で現在の model ID に揃え、次に request shape を移行します。`1K`、`2K`、`4K` の `K` は大文字のままにします。

laozhang.ai のような provider gateway を使う条件

Provider gateway は、OpenAI-compatible billing、支払い flow、gateway logs、multi-model routing、fallback access が必要な時に意味があります。laozhang.ai は API access、cost、quota、implementation routing の provider lane として扱えます。

ただし boundary は明確です。provider 価格は Google 公式価格ではありません。2026 年 7 月 1 日に確認した laozhang.ai 公開 docs には `0.09/image\` と \`0.09/edit` があり、provider alias language も残っています。production 前には provider console、model list、request log、billable event rule を source of truth にします。

安全な recommendation は conditional です。laozhang.ai を使うのは、現在の console と logs が model、price、billing、data、failure requirements を満たす時だけです。unlimited、no blocking、failed-call refund、guaranteed availability は証拠なしに書けません。

最初の request の troubleshooting

最初の request が失敗した時は、key、model、provider、payload を同時に変えないでください。signal が壊れます。

最小再現を残します。model ID、route、project、key type、image size、prompt、status code、request ID、billing evidence です。これがないと次の判断は推測になります。

Launch 前 checklist

Launch 前に owner を決めます。

• Model owner: `gemini-3-pro-image` が必要、または安い model が quality bar を失敗している。
• Price owner: Google Standard、Google Batch/Flex、provider console price が記録されている。
• Credential owner: auth key、restrictions、rotation policy が明確。
• Quota owner: live project/model limits と tier requirements を確認済み。
• Cost owner: resolution、retries、grounding、failed calls、provider billable events が log される。
• Data owner: Google または provider terms が送信する image input に合う。
• Fallback owner: resolution を下げる、Batch/Flex に移る、Nano Banana 2 に切る、provider を変える基準がある。
• Rollback owner: cheaper model または feature flag を用意している。

実務ルールは短いです。contract owner を選び、price と quota を証明し、それから code をコピーする。この順序なら Nano Banana Pro API が高価な debugging exercise になりにくくなります。

よくある質問

どの model ID を使うべきですか？

現在の Google 公式 Pro image model には `gemini-3-pro-image` を使います。`gemini-3-pro-image-preview` は active docs または provider console が要求しない限り legacy/provider alias として扱います。

Pro image API は無料ですか？

2026 年 7 月 1 日確認時点の Google pricing page には `gemini-3-pro-image` の free image-output tier はありませんでした。AI Studio の UI が使えることと paid API usage が無料であることは別です。

公式 Google 料金はいくらですか？

Standard image output は `1K/2K` が `0.134\`、\`4K\` が \`0.24`。Batch/Flex は `0.067\` と \`0.12` です。production 前に再確認してください。

laozhang.ai は Google 公式価格ですか？

いいえ。laozhang.ai は provider gateway です。公開 docs の `$0.09/image` は provider pricing であり、production では console と logs で確認します。

API key を増やすと quota は増えますか？

増えません。Google の rate limits は project-level であり per-key ではありません。複数 key は separation や rotation に役立ちますが quota を増やしません。

Batch/Flex はいつ使いますか？

Google first-party contract が必要で、async または flexible delivery を受け入れられる時です。interactive output には Standard の方が自然です。

後で再確認すべき source は？

Google image-generation、pricing、API-key、billing、rate-limit docs を再確認します。provider route では provider docs、console、model list、call logs も確認します。