# Nano Banana Pro API完全ガイド: 公式モデルID、料金、制限、クイックスタート

> Nano Banana Pro API の公式モデル ID を確認し、適切な Gemini ルートを選び、2026 年 3 月 27 日時点の料金、課金、制限を把握したうえで、最も時間を浪費しやすい導入ミスを避けます。

- Source: https://www.aifreeapi.com/ja/posts/nano-banana-pro-api
- Language: ja
- Published: 2026-03-27
- Updated: 2026-03-27
- Publisher: AI Free API (https://www.aifreeapi.com)

**2026 年 3 月 27 日時点で、Nano Banana Pro API が指すのは Google の `gemini-3-pro-image-preview` です。** 新しい統合を作るなら、最初に選ぶべきなのはサードパーティの別名でも Gemini の OpenAI 互換レイヤーでもなく、ネイティブな Gemini 画像生成ルートです。OpenAI 互換ルートを最初から選ぶ合理的な場面は、すでに OpenAI 形の SDK やクライアントがあり、書き換え量を最小化することが最優先である場合に限られます。

この結論が妥当なのは、SERP がまだかなり断片的だからです。検索結果の上位には `Nano Banana Pro API`、価格バッジ、短い curl スニペットを前面に出すページが多く並びますが、公式モデル ID、Paid Tier が必要になる条件、そして実際の制限をどこで確認するかまで、まとめて説明しているページは多くありません。Google の答えはより信頼できますが、[image-generation ドキュメント](https://ai.google.dev/gemini-api/docs/image-generation)、[OpenAI compatibility ドキュメント](https://ai.google.dev/gemini-api/docs/openai)、[pricing ページ](https://ai.google.dev/gemini-api/docs/pricing?hl=en)、[rate-limits ページ](https://ai.google.dev/gemini-api/docs/rate-limits) に分散しています。

そのため、このキーワードで最初に解くべき問題は価格比較ではなくルーティングです。まず公式モデル名を確認し、次に正しい API 面を選び、そのあとで課金状態とライブ制限を確認する。この順序を守ってからプロバイダーや中継サービスを比較したほうが、実装時間もデバッグ時間も短くなります。

![Nano Banana Pro API のガイド。公式モデル ID、推奨 API ルート、現在の料金、重要なセットアップ確認項目を示している](https://www.aifreeapi.com/posts/ja/nano-banana-pro-api/img/cover.png)

## 要点まとめ

| 状況 | 最初に使うもの | モデル | これが安全な初期値である理由 | 主な注意点 |
| --- | --- | --- | --- | --- |
| 新しい Google 公式統合 | ネイティブ Gemini `generateContent` | `gemini-3-pro-image-preview` | 現在の Google の image docs と最も整合する first-party 契約 | 本格運用には Paid Tier が必要で、制限はプロジェクトごとに変わる |
| 既存の OpenAI 風アプリや SDK がある | Gemini OpenAI-compatible endpoint | `gemini-3-pro-image-preview` | OpenAI 形のクライアントを維持しやすく、書き換え量が少ない | これは互換レイヤーであり、ネイティブ契約の学習には向かない |
| まずコストを見たい | 先に Google 公式価格、その後に relay 比較 | `gemini-3-pro-image-preview` | 公式基準価格がないとラッパー価格を正しく比較できない | プロバイダーのページは billing と limit の差を省略しがち |
| 文字入りポスターや高精度のプロ向け画像が必要 | 公式ルートを維持する | `gemini-3-pro-image-preview` | Gemini 3 の中でも高品質・高制御の image レーンだから | Flash Image より高価で、現在も preview 扱い |

次に気になることが価格なら [Nano Banana Pro API Pricing（英語）](/en/posts/nano-banana-pro-api-pricing) を、より汎用的な REST 呼び出しなら [Gemini Image Generation REST API](/ja/posts/gemini-image-generation-rest-api) を参照してください。API キー、セットアップ、課金については、このページ内でも英語の補助リンクを明示します。

## Nano Banana Pro API は通称であり、Google の正式なモデル名ではない

このクエリで最初に修正すべきは名前の理解です。`Nano Banana Pro` は Gemini 3 の高級 image レーンに対する Google の一般向けニックネームですが、正式な API モデル名は `gemini-3-pro-image-preview` です。Google の現在の [image-generation ドキュメント](https://ai.google.dev/gemini-api/docs/image-generation) では、次のように整理されています。

- `Nano Banana 2` = `gemini-3.1-flash-image-preview`
- `Nano Banana Pro` = `gemini-3-pro-image-preview`
- `Nano Banana` = `gemini-2.5-flash-image`

見た目には小さな違いですが、検索結果の多くを読むときの解釈を大きく変えます。いくつかのプロバイダーは `nano-banana-pro` のような独自エイリアスを公開しています。そのエイリアスはそのサービス内では使えるかもしれませんが、Google の正規のモデル文字列ではありません。それをそのまま Google への直接リクエストに貼り付けると、最初から間違ったレイヤーをデバッグすることになります。

Google の現在の [changelog](https://ai.google.dev/gemini-api/docs/changelog) によると、`gemini-3-pro-image-preview` の公開日は **2025 年 11 月 20 日** です。この日付が大事なのは、古いページの多くがプレリリース時代の名称、2.5 系 image モデル、あいまいな `Gemini 3.0 Pro` といった表現を混在させているからです。

モデルの位置づけも確認しておくべきです。[DeepMind のモデルページ](https://deepmind.google/models/gemini-image/pro/) では、Nano Banana Pro を高精度で制御性の高い Gemini 3 image モデルとして説明しています。[image-generation ドキュメント](https://ai.google.dev/gemini-api/docs/image-generation) では、プロ向けのアセット制作や複雑な指示に適しており、Gemini 3 image モデルは最大 14 枚の参照画像を組み合わせられるとされています。Google はまた、すべての生成画像に SynthID が含まれることも明記しています。

ここまでをまとめると、理解すべきポイントは次のとおりです。

- `Nano Banana Pro` はプロダクト向けの通称。
- `gemini-3-pro-image-preview` は公式 API で使うべき文字列。
- サードパーティの別名はラッパーの都合であり、first-party の正式名ではない。

この前提が固まれば、次に考えるべき実務的な問いはひとつです。どの API ルートから始めるべきか。

## どのAPIルートから始めるべきか

![ネイティブ Gemini ルート、OpenAI 互換ルート、relay provider ルートを比較する意思決定ボード](https://www.aifreeapi.com/posts/ja/nano-banana-pro-api/img/route-decision-board.png)

ほとんどの読者にとって答えは明快です。**まずはネイティブ Gemini API から始めるべきです。** モデルに初めて触れる場合、raw HTTP で試す場合、公式 docs に沿って理解したい場合、最初の成功レスポンスを確認したい場合、このルートが最もわかりやすい出発点になります。

理由は思想ではなく明瞭さです。Google の現在の [image-generation ガイド](https://ai.google.dev/gemini-api/docs/image-generation) は、ネイティブ Gemini の `generateContent` 契約を前提に画像出力を説明しています。モデルマッピング、画像サイズ、aspect ratio、Gemini 3 の各 image レーンは、この表面で最もストレートに整理されています。検索から最初の正しい Google リクエストまでを最短でつなぐなら、ここが最もクリーンです。

**Gemini OpenAI-compatible route** も正式に存在し、Google は [OpenAI compatibility ページ](https://ai.google.dev/gemini-api/docs/openai) でこれをサポートしています。`client.images.generate` から `gemini-3-pro-image-preview` を呼べるので、既存の OpenAI 形アプリや SDK 規約を崩したくない場合には有効です。ただし、新規統合の標準ルートとしては適しません。互換レイヤーの向こう側にネイティブ契約が隠れてしまい、どこで何が起きているかを理解しにくくなるからです。

したがって、実務上の分け方は次のようになります。

- 公式ルートを学ぶ、ゼロから構築する、raw request をデバッグするなら **ネイティブ Gemini**。
- OpenAI 形クライアントを維持することが主目的なら **Gemini OpenAI compatibility**。
- 公式モデル、公式価格、billing surface を理解したあとで **relay provider** を比較する。

最後の分岐が重要です。検索上位には、製品そのもののように見える provider ページが多くあります。しかし、それらは製品そのものではなく、製品への一つのアクセス経路です。この差を理解しないまま読み進めると、Google の API 挙動ではなく、誰かの gateway のルールを比較することになります。

## 課金、料金、そして実際の制限はどこで確認するか

![公式の Nano Banana Pro API 料金、Batch 割引、課金要件、AI Studio でライブ制限を確認する必要があることを示すボード](https://www.aifreeapi.com/posts/ja/nano-banana-pro-api/img/pricing-limits-board.png)

ルーティングの問題と課金の問題は、多くのランディングページが示す以上に密接に結びついています。

Google の [billing ページ](https://ai.google.dev/gemini-api/docs/billing/) では、新しい Gemini API アカウントは Free Tier から始まり、Paid Tier に移行するには billing account のリンクと最低 $10 の前払いが必要だと説明されています。同じページには、**2026 年 3 月 23 日** に始まった一時的な prepay-to-postpay migration 状態も書かれています。実務上の要点は明確で、API キーを取得しただけではセットアップ完了とは言えません。モデル名もエンドポイントも正しくても、課金状態がプロジェクト要件と一致していなければ、画像生成は失敗したり、期待と異なる挙動になったりします。

現在の Google 公式 [pricing ページ](https://ai.google.dev/gemini-api/docs/pricing?hl=en) に基づく料金は次のとおりです。

| Google 公式ルート | 現在の有料価格 |
| --- | --- |
| Gemini 3 Pro Image Preview、1K または 2K 出力 | 1 枚あたり $0.134 |
| Gemini 3 Pro Image Preview、4K 出力 | 1 枚あたり $0.24 |
| Gemini 3 Pro Image Preview、Batch API、1K または 2K | 1 枚あたり $0.067 |
| Gemini 3 Pro Image Preview、Batch API、4K | 1 枚あたり $0.12 |

比較を始めるときは、まずこの公式基準を頭に入れるべきです。検索上位の provider ページの多くは、Google の基準価格を知る前に、自分たちの credit 価格や代理価格を印象づけようとします。まず公式基準を持っておけば、wrapper の価格比較にも意味が出ます。もし本当に解きたい問題が「もっと安い経路はないか」であれば、[Nano Banana Pro Cheap API Alternative（英語）](/en/posts/nano-banana-pro-cheap-api-alternative) を見たほうが早いです。

制限については、古い記事がもっとも誤解を広げやすい部分です。Google の [rate-limits ページ](https://ai.google.dev/gemini-api/docs/rate-limits) は、誰にでも永続的に適用される単一の RPM を提示していません。代わりに、次の点を明確にしています。

- 制限は **project 単位** で適用される
- requests per day は **太平洋時間の深夜** にリセットされる
- preview モデルは **より厳しい制限** を持ちやすい
- ライブ制限は **AI Studio** で確認すべき

だからこそ、このページでは固定の universal RPM を繰り返しません。多くのページはいまだにそう書いていますが、Google 自身の説明はもっと条件依存です。安全なデフォルトは、AI Studio を現在の live limits の確認場所として扱うことです。

## クイックスタート: 最初の Nano Banana Pro API リクエストを通す

最初の検証として最も安全なのは、1 本の公式 Google リクエスト、1 つの正しいモデル名、1 枚の画像です。最初の目的がルートの証明であるなら、provider alias、batch pipeline、複雑な中継サービスから始めるべきではありません。

### ネイティブ Gemini ルート

```bash
curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {
          "text": "Create a clean 16:9 product hero image of a matte black travel mug on a light concrete surface with soft studio lighting and premium ecommerce styling."
        }
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'
```

このリクエストは、公式ルートそのものを直接証明します。Google の正規モデル文字列、現在のネイティブ Gemini 契約、Gemini 3 image generation 向けに Google が文書化している設定フィールドを使っています。

ネイティブルートでは、扱いやすい hosted URL ではなく、レスポンス内部に画像バイトが返ることが一般的です。だからこそ、これが最初の proof として適しています。実際のレスポンス形状が見えれば、アクセス権の問題か、モデル選択の問題か、自分の保存ロジックの問題かを切り分けやすくなります。

### Gemini OpenAI 互換ルート

すでに OpenAI 形のクライアントを持っていて、互換レイヤーを意図的に使いたい場合は、Google の docs がこのルートもサポートしています。

```python
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)

result = client.images.generate(
    model="gemini-3-pro-image-preview",
    prompt="Create a clean 16:9 product hero image of a matte black travel mug on a light concrete surface with soft studio lighting and premium ecommerce styling.",
    size="2K",
    n=1,
)
```

この経路は、例が短く見えるからではなく、OpenAI 形を維持すること自体が目的であるときに選ぶべきです。

最初の成功レスポンスが取れたら、次の一手は残っている疑問次第です。

- **billing** が詰まりどころなら [Nano Banana Pro Google AI Studio Billing（英語）](/en/posts/nano-banana-pro-google-ai-studio-billing)。
- **API key** が詰まりどころなら [Nano Banana Pro API Key（英語）](/en/posts/nano-banana-pro-api-key)。
- **セットアップ全体** を見直したいなら [Nano Banana Pro API Setup（英語）](/en/posts/nano-banana-pro-api-setup)。
- **より一般的な image REST 呼び出し** を見たいなら [Gemini Image Generation REST API](/ja/posts/gemini-image-generation-rest-api)。

## セットアップ後によく起きる失敗

![課金の問題、429 制限、503 サービスエラー、IMAGE_OTHER 失敗をどう切り分けるかを示すトラブルシューティング図](https://www.aifreeapi.com/posts/ja/nano-banana-pro-api/img/failure-triage-map.png)

このクエリは、最初のコード例のすぐあとにサポート問題へ変わりやすいです。そのため、この章は一般的な機能紹介よりも価値があります。

Google の公式 docs は billing と limit の所在を説明していますが、実際の実装時の摩擦はコミュニティのスレッドのほうが見えやすいです。[Google Developers Forum のスレッド](https://discuss.ai.google.dev/t/gemini-3-pro-image-preview-failures-when-called-by-aws-lambda-function/111440) では、AWS Lambda では再現するがローカルでは再現しない `IMAGE_OTHER` 失敗が報告されています。[Reddit のスレッド](https://www.reddit.com/r/googlecloud/comments/1pddakx/gemini_3_image_api_spamming_503_and_429_for_hours/) では、rate-limit の枯渇と backend capacity の問題が混同されやすいことが見て取れます。

まず使える切り分け表は次のようなものです。

| 表示される症状 | それが意味しやすいこと | 最初に確認すべきもの |
| --- | --- | --- |
| billing 関連エラー、あるいは paid access がない | ルートは正しいが、プロジェクトの課金状態がまだ合っていない | Paid Tier 設定と project の紐付け |
| `429 Resource Exhausted` | project-level limit か、preview モデル特有の厳しい quota window に当たった | まず AI Studio で live limits を確認する |
| `503 Service Unavailable` | 多くの場合はモデル名の誤記ではなく、サービス側の容量問題 | リトライし、負荷を下げ、すぐに endpoint を疑わない |
| 正しいモデル ID なのに `IMAGE_OTHER` や image generation failure が出る | リクエスト形状は通ったが、現在条件では生成が完了できなかった | prompt を簡略化し、環境差を切り分ける |
| ネイティブルートは通るが互換ルートだけ振る舞いが違う | 二つの契約を同じものとしてデバッグしている | まず一方の surface を完全に安定させる |

大事なのは、層ごとにデバッグすることです。まず official model ID、次に billing、その次に route、そのあとで compatibility layer や provider gateway を見る。これだけで、一般論の最適化テクニックよりもずっと多くの時間を節約できます。

## relay provider を使うべきなのはどんなときか

公式ルートが理解できたあとであれば、relay provider に意味がある場面はあります。SERP にそれらが多いのにも理由があります。典型的には次の四つです。

- 複数の image モデルを一つの OpenAI-style gateway で扱いたい
- ベンダー横断の billing を一本化したい
- 自分のトラフィック形状に合った provider 独自の price plan がほしい
- 直接の Google billing より速く商用オンボーディングしたい

ただし、それらは **公式 baseline の理解を置き換えるものではありません。** `nano-banana-pro` のような alias や credit 価格だけを前面に出すページを見ても、背後の公式モデル、Google の直価格、ライブ制限の本当の由来は自分で把握しておくべきです。

だからこのハブ記事は official-first を維持しています。その後で relay を比較するのは問題ありませんが、Google 公式 surface を理解しないままそこから始めるのは遠回りです。

より安い、あるいは簡単な gateway を探したい場合は、次の英語ページも役立ちます。

- [Nano Banana Pro Cheap API Alternative（英語）](/en/posts/nano-banana-pro-cheap-api-alternative)
- [How to Call Nano Banana Pro via API（英語）](/en/posts/how-to-call-nano-banana-pro-via-api)
- [Nano Banana Pro API Pricing（英語）](/en/posts/nano-banana-pro-api-pricing)

## FAQ

**Nano Banana Pro API に対応する Google の正式モデル名は何ですか。**

正式なモデル文字列は `gemini-3-pro-image-preview` です。`Nano Banana Pro` は通称であり、公式 API モデル名ではありません。

**ネイティブ Gemini API を使う必要がありますか。それとも OpenAI 互換クライアントでも大丈夫ですか。**

どちらも使えます。新しい統合ではネイティブ Gemini ルートが最も安全な初期値です。OpenAI 互換クライアントを維持することが主目的なら、Gemini の OpenAI 互換ルートが適しています。

**実際のライブ制限はどこで確認すればよいですか。**

Google の現在の rate-limits ページは、アクティブな制限を AI Studio で確認するよう案内しています。公開 docs はルールを説明しますが、現在のプロジェクト状態は AI Studio で確認するのが安全です。

**Nano Banana Pro API を本格運用するには billing が必要ですか。**

はい。Google の billing docs によれば、Paid Tier へ移るには billing account のリンクと最低 $10 の前払いが必要です。API key を取得しただけでは、必要な運用ルートが保証されるわけではありません。

**生成画像には SynthID が含まれますか。**

はい。Google の image-generation docs では、生成画像に SynthID が含まれると明記されています。

## まとめ

`Nano Banana Pro API` は謎の第三者製品ではありません。Google の `gemini-3-pro-image-preview` です。

新規導入ならまずネイティブ Gemini ルートから始めるべきです。すでに OpenAI 形のクライアントがあり、移行コストを抑えることが最重要なら、Gemini の OpenAI 互換レイヤーを意図的に選んでください。どちらのルートでも、最初の判断基準は Google 公式の価格、課金、制限ページに置くべきです。