Nano Banana AI画像生成API 2026: 公式Gemini導入、モデル選択、動くコード

いま 公式の Nano Banana API を探しているなら、探すべきものは独立した Nano Banana の開発者向け製品ではありません。実際に探しているのは Gemini API か Google AI Studio にある Gemini のネイティブ画像生成モデル です。大半の API ユースケースでは、最初に使うべき安全な default は Nano Banana 2 で、現在の公式 model ID は gemini-3.1-flash-image-preview です。Nano Banana Pro（gemini-3-pro-image-preview）に上げるのは、text rendering、複雑な instruction following、あるいは professional asset production 級の品質が本当に必要だと説明できるときだけで十分です。

この即答が重要なのは、この query の周辺に誤解を強める近道が多いからです。Nano Banana を独立 app のように扱うページもあれば、AI Mode を API だと受け取らせるページもありますし、wrapper/gateway を製品そのもののように見せるページもあります。正しい見方はもっと単純です。Nano Banana は Gemini のネイティブ画像ファミリーであり、公式 developer path は Gemini API + AI Studio、そして最初に試すべきモデルは Nano Banana 2 です。

以下の model ID、価格、consumer limits はすべて 2026年3月29日 時点で Google の現行 docs、Help、Pricing を再確認しています。

要点

まずは最短の答えです。

一番大事な一文はこれです。"Nano Banana API" は Gemini API の話として理解すべきであって、単独の Nano Banana サイト探しではありません。

Nano Banana API はいま何を指すのか

Google の現行 image-generation docs では、Nano Banana は Gemini のネイティブ画像生成能力を指しており、単一の surface ではありません。API 文脈では次の family を考えるのが正確です。

多くの検索結果がまだ取りこぼしているのはここです。query だけ見ると、ひとつの "Nano Banana API" 製品、ひとつのアカウント導線、ひとつの obvious model があるように見えます。しかし Google の現在の見せ方は違います。いま必要なのは family choice と surface choice の切り分けです。

• family のどの version が必要か
• 公式 API が必要なのか、公式 testing UI が必要なのか、consumer surface が必要なのか

もうひとつ重要なのは、画像生成そのものが Gemini の通常の入出力契約の一部 だという点です。現行 docs には request shape、image editing、aspect ratio、image size、search grounding まで含まれています。さらに Google は すべての generated images に SynthID watermark が含まれる と明記しています。provenance や AI disclosure を気にするチームなら、この点は見逃せません。

より広い現行アクセスガイドが必要なら、Nano Banana AI画像生成ガイド を見てください。このページはそこから一段狭く、公式 API に正しく入る ことだけに集中しています。

どれが公式 API で、どれがそうではないのか

もっとも混乱しやすいのは、Gemini Apps、AI Mode、AI Studio、Gemini API、wrapper を全部同じ箱に入れてしまうことです。互いに関係はありますが、同じ contract ではありません。

Gemini API が公式の programmatic path です。generateContent を呼び、prompt や input image を送り、inline image output を受け取り、aspect ratio や image size を制御したいなら、ここが答えです。

Google AI Studio は、その同じスタックを試すための公式 testing / development surface です。prompt を試し、model behavior を観察し、結果を UI で確認してからコードに落としたいときに向いています。ここで重要なのが Google の 2026 年 2 月 26 日の Nano Banana 2 rollout post で、AI Studio で Nano Banana 2 を使うには paid API key が必要 と明記していることです。つまり AI Studio は公式 developer UI であって、preview image pricing を回避する free loophole ではありません。

Gemini Apps と AI Mode は実際の製品向け入口ですが、一般利用向けの route であって API query の答えではありません。Gemini Apps Help は Nano Banana と Nano Banana Pro の everyday use と advanced output を分けており、AI Mode Help は image limits と Pro の infographic / diagram 向け positioning を別に説明しています。これは利用者側の判断には重要ですが、API 契約そのものを変える話ではありません。

Wrapper / gateway は別レイヤーの infrastructure choice です。OpenAI-compatible requests、multi-vendor routing、統一 billing など、明確な infra reason があるなら役に立ちます。ただしそれは第二の判断であって、第一の判断ではありません。

最小のルーティング規則はこうです。

• コードを書くなら Gemini API
• 公式 UI で prompt を試すなら AI Studio
• API ではなく一般利用を解いているなら Gemini Apps か AI Mode
• gateway は infra reason を言えるときだけ

まずは Nano Banana 2、Pro は override 理由があるときだけ

多くの読者にとって、ここが最も価値の高い判断です。

Google の現行 image-generation docs は Nano Banana 2 を Pro の高効率 counterpart として説明し、速度と high-volume developer use cases に最適化されたモデルだとしています。さらに Google 自身の 2026 年 2 月の rollout post では Nano Banana 2 を "our best image generation and editing model" と呼んでいます。API guide として読むなら、これは「Pro が premium だから default」という考え方をやめるべきだという意味です。

Nano Banana 2 から始めるべきなのは、次のような場合です。

• 初めての integration を作る
• iteration speed と price efficiency を重視する
• ある程度の volume を見込んでいる
• general image generation / editing の安全な default が欲しい
• まだ Pro に上げる明確な理由がない

Nano Banana Pro に上げるべきなのは、次のような場合です。

• text rendering quality が結果の中心になる
• 画像が final asset であり、単なる draft ではない
• より強い reasoning で complex visual instructions を処理したい
• diagram-heavy、layout-sensitive、brand-critical な仕事である

そして Nano Banana（gemini-2.5-flash-image）にもまだ居場所があります。

• すでにその旧 fast route に最適化した workload がある
• Nano Banana 2 の behavior よりも low latency を優先したい

重要なのは、これは単なる quality ladder ではないということです。これは workload fit の問題です。Nano Banana 2 は Pro の安い代替ではなく、Google が現行 docs 上で中心に置いている default です。Pro は premium override です。この判断のほうが、多くの wrapper pages に残る曖昧な "better quality だから Pro" よりずっと実務的です。

より深い workload-level 比較が必要なら、Nano Banana Pro vs Nano Banana 2 の比較記事 を参照してください。このページはそこまで広げず、正しい start point を決めることに集中しています。

Quickstart: 最初のリクエストを動かす

公式 path は、third-party tutorial が見せるほど長くありません。

1. Gemini API key を取得する

まずは Google AI Studio で key を作ります。Google は key creation 自体を簡単にしていますが、それは image output が無料だという意味ではありません。現行の preview-image pricing をそのまま読むなら、正しい理解は次の 2 行です。

• key を作るのは簡単
• 現行の preview image models を使うのは paid API path

2. 現行の公式 SDK を入れる

Google の libraries page は現在 Google GenAI SDK を推しており、古い Gemini client libraries を推奨経路には置いていません。

bash

npm install @google/genai

# Python
pip install -U google-genai

google-generativeai ベースの古い snippet を見かけても、それは history として読むべきで、現行の最適ルートではありません。

3. 最小の image-generation request を送る

新しい integration なら、最初は Nano Banana 2 で十分です。

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

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

const response = await ai.models.generateContent({
  model: "gemini-3.1-flash-image-preview",
  contents: "Create a clean editorial illustration of a robot sketching a website wireframe.",
  config: {
    responseModalities: ["IMAGE"],
    imageConfig: {
      aspectRatio: "16:9",
      imageSize: "2K",
    },
  },
});

for (const part of response.candidates[0].content.parts) {
  if (part.inlineData) {
    fs.writeFileSync("output.png", Buffer.from(part.inlineData.data, "base64"));
  }
}

Python 版もロジックは同じです。

python
import os
from google import genai
from google.genai import types

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Create a clean editorial illustration of a robot sketching a website wireframe.",
    config=types.GenerateContentConfig(
        response_modalities=["IMAGE"],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K",
        ),
    ),
)

for part in response.parts:
    if part.inline_data is not None:
        part.as_image().save("output.png")

raw HTTP を確認したいなら、公式 REST shape も非常に短いです。

bash
curl -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "x-goog-api-key: ${GEMINI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {"text": "Create a clean editorial illustration of a robot sketching a website wireframe."}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

Pro に切り替える方法が "退屈" なのは、むしろ利点です。request shape はそのままで、model ID を gemini-3-pro-image-preview に変えるだけでよいからです。だからこそ "まず Nano Banana 2 で始め、必要なら Pro に上げる" という workflow が実務的なのです。

Wrapper を前提に設計する前に知っておきたい公式 API の強み

公式 Gemini route を baseline にすべきなのは、単に "公式だから" ではありません。実際の capability が、wrapper landing pages で想像されるより広いからです。

Image editing は標準機能です。 現行 image-generation docs は prompt-only generation だけでなく text-and-image-to-image workflow も示しています。編集ワークフローが必要な product では、これが重要です。

Aspect ratio と image size を明示的に制御できます。 公式 API は imageConfig.aspectRatio を持ち、現行の preview image models では 0.5K から 4K までの image sizes を Google がドキュメント化しています。つまり、cost と latency の tradeoff を自分の product 側で明確に設計できます。

Search grounding も公式 stack の一部です。 image-generation docs は google_search tool を image generation に付ける現行ルートを示しています。charts、weather visuals、grounded infographic などには非常に有効です。ただし、これは "無料で何でも検索できる" という意味ではありません。pricing page では search grounding が shared free allowance を超えた後に別課金されると読めます。

SynthID も platform 側が処理します。 provenance、disclosure、AI-content labeling を考える product では、この点はかなり重要です。Google は all generated images include a SynthID watermark と明記しています。

Nano Banana を最初に wrapper 経由で理解すると、こうした点は見えにくくなります。ですが、本当に比較すべきなのはこの capability baseline です。

価格と "無料" の境界: いちばん混同されやすい場所

Nano Banana API に関する悪い advice は、たいていここで崩れます。

現行の Gemini Developer API pricing page は、2 つの preview image models に対してどちらも Free Tier: Not available と表示しています。2026年3月29日 時点の公式価格は次の通りです。

この表を頭に入れるだけで、多くのランキング記事が何を混ぜているか見えやすくなります。もし現行の Nano Banana preview-image API を "free to start" のように書いているのに契約の違いを説明していないなら、ほぼ確実に次のいくつかを混同しています。

• free な key creation
• AI Studio の試用文脈
• Gemini や AI Mode の consumer quotas
• 過去の、あるいは別 family の free-tier story

これらは同じ契約ではありません。

一般向けサービスには一般向けサービスのルールがあります。Gemini Apps Help は現在、Nano Banana 2 の image generation / editing について 20 / 50 / 100 / 1000 images / day の shape を no plan / Google AI Plus / Google AI Pro / Google AI Ultra に対して示しています。AI Mode Help も 20 / 50 / 100 / 1000 images in a 24-hour period の shape を示し、さらに Nano Banana Pro in AI Mode is optimized for infographics and diagrams と書いています。これは利用者側の判断には有益ですが、現行の preview image API を無料にするものではありません。

もし本当の関心が "Nano Banana API の価格" なら、Nano Banana 2 API pricing guide と Gemini Image API の包括ガイド をあわせて読むほうが役立ちます。ここではルート選びと導入を先に解いています。

30 秒で決める

最小の判断表だけ欲しいなら、これです。

新しい公式連携を作るなら、Gemini API + Nano Banana 2。

作業が text rendering、visual fidelity、professional asset quality に本当に依存するなら、Nano Banana Pro。

Google の UI で先に prompts を試したいなら、AI Studio。

API integration ではなく一般利用を解きたいなら、Gemini Apps か AI Mode。

wrapper が必要なら、OpenAI 互換ルーティングなどの infra reason を先に言えるときだけ。

これが現時点で最もきれいで実用的な答えです。

FAQ

公式の Nano Banana API とは何ですか。
Gemini のネイティブ画像ファミリーが Gemini API と Google AI Studio 経由で exposed されたもので、独立した Nano Banana developer product ではありません。

最初に使うべき model は何ですか。
最初は gemini-3.1-flash-image-preview で十分です。より高価な Pro が必要だと最初から分かっている場合だけ例外です。

Nano Banana Pro の公式 model ID は何ですか。
gemini-3-pro-image-preview です。

Nano Banana API は無料ですか。
現行 pricing page の通り、preview image models 自体には free tier の image output はありません。consumer quotas や AI Mode usage は別契約です。

AI Studio と Gemini API のどちらを使うべきですか。
両方を併用するのが合理的です。AI Studio で公式に prompt を試し、Gemini API でアプリに組み込みます。

AI Mode は API の一部ですか。
いいえ。AI Mode は Search の consumer surface であり、独自の image limits と product behavior を持ちます。

API は image editing にも対応していますか。
はい。Google の image-generation docs は image-to-image workflow を現行ルートとして示しています。

生成画像には watermark が付きますか。
はい。Google は generated images に SynthID watermark が含まれると説明しています。

それでも gateway が必要ならどうすればいいですか。
現在の公式 Gemini API は、多くのチームにとって重要な control points、つまり model selection、image editing、aspect ratio、image size、search grounding をすでに備えています。それでも足りない場合にだけ、gateway を明確な infra choice として追加するのが正しい順序です。