Nano Banana 2 開発ドキュメント完全攻略：公式APIとAPIYI連携の2つのプラン比較

title: "Nano Banana 2 開発ドキュメント詳解：Google公式 vs APIYI、最適な接続プランはどっち？"
description: "Nano Banana 2（gemini-3.1-flash-image-preview）の開発ドキュメントを徹底解説。Google公式APIとAPIYIプラットフォームの2つの接続プランを比較し、パラメータ設定やコスト削減戦略を紹介します。"

著者注：Nano Banana 2（gemini-3.1-flash-image-preview）の開発ドキュメント詳解。Google公式APIとAPIYIプラットフォームの2つの接続プランを比較し、完全なコード例、パラメータ設定、コスト削減戦略を解説します。

Nano Banana 2 を導入したい開発者の方向けに、現在2つの開発ドキュメントが用意されています。Google公式ドキュメント（ai.google.dev/gemini-api/docs/image-generation）と、APIYIプラットフォームのドキュメント（docs.apiyi.com/api-capabilities/nano-banana-2-image）です。

2つのプランにはそれぞれ利点があります。公式ドキュメントは機能が最も充実しており、APIYIのドキュメントは接続が非常に簡単で、価格も1回あたり $0.03 からと低価格です。この記事では、2つのドキュメントの核心内容を統合・比較し、あなたに最適な接続方法の選択をサポートします。

核心的な価値：この記事を読み終える頃には、Nano Banana 2 の全APIパラメータ、2つの接続プランのコード例、そしてシーン別の最適な選択肢をマスターしているはずです。

Nano Banana 2 開発ドキュメント核心パラメータ速報

まずは最も重要なパラメータ設定を確認しましょう。どちらのプランで接続する場合でも、これらのパラメータは共通です。

Nano Banana 2 がサポートする14種類のアスペクト比

🎯 開発ヒント：1:4、4:1、1:8、8:1 は Nano Banana 2 独自の新しいアスペクト比であり、Nano Banana Pro ではサポートされていません。アプリケーションで長いバナーやインフォグラフィックが必要な場合は、gemini-3.1-flash-image-preview を使用する必要があります。

Nano Banana 2 連携プラン A：Google公式API

公式APIの基本呼び出し

Google公式APIは Google Gen AI SDK を使用し、Python、JavaScript、Go、Java、および REST をサポートしています。

from google import genai
from google.genai import types

client = genai.Client()

# 基本的なテキストから画像生成
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="秋の落ち葉の中で転がっている茶トラ猫、暖色系",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE']
    )
)

# 生成された画像を抽出
for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)

from google import genai
from google.genai import types

client = genai.Client()

# フルパラメータ設定：2K解像度 + 16:9ワイドスクリーン + High思考モード
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="IT企業の年次報告書の表紙、タイトル 'AI Vision 2026'、ダークブルー基調、ミニマルスタイル",
    config=types.GenerateContentConfig(
        response_modalities=['TEXT', 'IMAGE'],
        image_config=types.ImageConfig(
            aspect_ratio="16:9",
            image_size="2K"
        ),
        thinking_config=types.ThinkingConfig(
            thinking_level="High",
            include_thoughts=True
        )
    )
)

# レスポンスの解析（思考プロセスを含む）
for part in response.parts:
    if part.thought and part.text:
        print(f"[思考プロセス] {part.text}")
    elif part.inline_data:
        with open("report_cover.png", "wb") as f:
            f.write(part.inline_data.data)
        print("画像が保存されました")

公式APIの Image Search 連携生成

これは Nano Banana 2 独自の機能で、生成前に Google 画像検索を実行してリアルな視覚リファレンスを取得します。

response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="2026年最新モデルのテスラ Model Y、シルバー、都市の街

## Nano Banana 2 の2つのプランの価格比較

| モデル | 公式標準価格 | 公式 Batch 価格 | APIYI の価格 | APIYI vs 公式 |
|------|-----------|-------------|-----------|--------------|
| **Nano Banana 2** | $0.067/枚（1K） | $0.034/枚 | **$0.03/回** | 55% お得 |
| **Nano Banana Pro** | $0.134/枚 | $0.067/枚 | **$0.05/回** | 63% お得 |
| **Nano Banana（初代）** | $0.039/枚 | — | **$0.025/回** | 36% お得 |

<br>

### Nano Banana 2 月間コスト比較（1日1,000枚の場合）

| プラン | 月間コスト（1K解像度） | 年間コスト |
|------|-------------------|--------|
| **公式標準** | $2,010 | $24,120 |
| **公式 Batch** | $1,020 | $12,240 |
| **APIYI** | **$900** | **$10,800** |

<br>

APIYIの $0.03/回という価格は、公式標準価格より55%安いだけでなく、公式のBatch半額（$0.034）よりもさらに低価格です。しかも、24時間の非同期処理を待つ必要がなく、リアルタイムで結果が返ってきます。

> 🎯 **節約プラン**：APIYI（apiyi.com）を通じて Nano Banana 2 を呼び出せば、1日1,000枚でわずか $30、月間コストは $900 です。新規登録で無料テストクレジットをプレゼント。1つのAPIキーで Nano Banana 2、Pro、およびその他の主要モデルを同時にサポートします。

---

## Nano Banana 2 高度な機能の開発ガイド

### マルチターン対話による画像編集

Nano Banana 2 は、対話を通じて同じ画像を継続的に修正することをサポートしています。

```python
# APIYI + OpenAI 形式のマルチターン編集
messages = [
    {"role": "user", "content": "シンプルでミニマルなスタイルのブランドロゴを生成して。ブルー系で。"},
    # 第1ターンの結果が返ってきた後に編集を継続
    {"role": "assistant", "content": "[第1ターンの生成結果]"},
    {"role": "user", "content": "色をグラデーションのパープルに変更して、会社名 'TechFlow' を追加して。"}
]

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=messages
)

Nano Banana 2 参照画像生成

Nano Banana 2 Thinkingモードの選択

🎯 開発のヒント：Thinkingトークンは、includeThoughts=true の設定に関わらず課金が発生します。推論プロセスを確認する必要がない場合は、デフォルトの false のままで問題ありません。生成品質には影響せず、中間推論テキストが返されないだけです。

Nano Banana 2 生成速度リファレンス

推奨：Nano Banana 2 を呼び出す際は、ネットワークの不安定さやGoogle側の計算リソースの変動によるタイムアウトエラーを防ぐため、timeout=300（300秒）に設定することをお勧めします。APIYI（apiyi.com）経由で呼び出すことで、より安定した接続が可能です。

よくある質問

まとめ

Nano Banana 2 開発ドキュメントの主なポイントは以下の通りです：

1. 2つのプランのメリット：Google公式APIは機能が最も充実しており（画像検索、Thinking、14枚の参照画像）、APIYIは価格が最も安く（1回0.03ドル）、導入が非常に簡単です。
2. APIYI 0.03ドル = 公式の45%：リアルタイムで結果を返し、公式のバッチ（Batch）価格（0.034ドル）よりも安価です。24時間待つ必要もありません。
3. 共通のコアパラメータ：4段階の解像度、14種類のアスペクト比、Thinkingモードなどのパラメータは、どちらのプランでも利用可能です。

ほとんどの開発者には、APIYI apiyi.com を通じた Nano Banana 2 の導入をお勧めします。1回0.03ドルという低価格、OpenAI互換フォーマット、登録時の無料クレジット提供により、5分以内に最初の画像を生成できます。

📚 参考資料

1. Google公式 Gemini 画像生成ドキュメント: Nano Banana 2 完全APIリファレンス

   • リンク: ai.google.dev/gemini-api/docs/image-generation
   • 説明: すべてのパラメータ、機能、高度な特性に関する公式ドキュメント

2. APIYI Nano Banana 2 ドキュメント: クイック導入とコード例

   • リンク: docs.apiyi.com/api-capabilities/nano-banana-2-image
   • 説明: APIYIプラットフォームの導入ガイド。料金体系と呼び出し例を含む

3. Gemini API 公式価格: 各解像度の詳細な価格

   • リンク: ai.google.dev/gemini-api/docs/pricing#gemini-3.1-flash-image-preview
   • 説明: 0.5K/1K/2K/4Kの標準価格およびバッチ価格

4. Gemini API レート制限: Previewモデルの呼び出し制限

   • リンク: ai.google.dev/gemini-api/docs/rate-limits
   • 説明: Previewモデルの割り当て制限について

著者: APIYI 技術チーム
技術交流: コメント欄であなたの Nano Banana 2 開発体験をぜひ共有してください。その他のAIモデル資料については、APIYI docs.apiyi.com ドキュメントセンターをご覧ください。