> ## Documentation Index
> Fetch the complete documentation index at: https://docs.widerouter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Nano Banana シリーズ
> WideRouter 上の Google の画像生成モデル：どの ID がどのサーフェスで動作するか、受け付けるすべてのパラメータ、実測レイテンシ。
Nano Bananaは、この画像モデル世代におけるGoogleのシリーズ名です。
WideRouterでは、**モデルIDは公式のものです** — プラットフォーム固有のエイリアスはなく、`-preview`が付いた名前は受け付けられません。
シリーズ内のすべてのモデルは同じリクエスト形式を使用するため、モデルの切り替えは`model`を1語変更するだけです。
## シリーズの概要
| | Nano Banana Pro | Nano Banana 2 | Nano Banana |
| -------------------- | -------------------- | ------------------------ | ------------------------ |
| **モデル ID** | `gemini-3-pro-image` | `gemini-3.1-flash-image` | `gemini-2.5-flash-image` |
| 非同期タスク API | はい | はい | まだ利用できません |
| 同期 API | はい | はい | まだ利用できません |
| 解像度ティア | `1K` `2K` `4K` | `1K` `2K` `4K` | — |
| 1 回の呼び出しあたりの画像数（`n`） | 1～4 | 1～4 | — |
| 参照画像 | 最大 14 枚 | 最大 14 枚 | — |
| 非同期、1K、平均 | 約 29 秒 | 約 20 秒 | — |
| 同期ラウンドトリップ、1K | 約 17 秒 | 約 13 秒 | — |
現在、`gemini-2.5-flash-image` はどちらのインターフェースでもルーティングされません。非同期
API では送信時に `model_not_supported` で拒否され、同期エンドポイントでは
料金設定エラーが返されます。公式 ID を検索した際に何も表示されないのではなく、
回答が得られるよう、ここに記載しています。プラットフォーム側の問題が修正され次第、
有効化される予定です。
デフォルトでは **Nano Banana 2** を選択してください。すべての解像度で実質的に高速で、同じパラメーターを受け取るため、インテグレーションを変更する必要はありません。画像 1 枚あたり約 10 秒の追加時間に見合う品質向上が必要な場合は、**Nano Banana Pro** に切り替えてください。
## パラメーター
すべては `input` の中に入ります。その周囲のエンベロープ — `model`、`input`、
`callback_url` — については、[非同期タスク API](/ja/api/async-tasks)で説明しています。
この5つのフィールドが完全なセットです。`input` 内のその他のキーは `invalid_params` で拒否されるため、入力ミスは無視されず、明確に失敗します。
| フィールド | 型 | 必須 | 範囲 | デフォルト |
| -------------- | --------- | --- | --------------------------- | ----------- |
| `prompt` | string | はい | 1～32000バイト | — |
| `n` | integer | いいえ | 1～4 | 1 |
| `aspect_ratio` | string | いいえ | [アスペクト比](#aspect-ratios)を参照 | モデル独自のデフォルト |
| `image_size` | string | いいえ | `1K` `2K` `4K` | `1K` |
| `images` | string\[] | いいえ | 最大14項目 | なし |
`image_size` は大文字と小文字を区別します。`1K` は受け付けられますが、`1k` は受け付けられません。非同期 API には `512` ティアはなく、自由形式の `1024x1024` 形式もありません。
## 解像度ティア
`image_size`は一方の辺を固定するのではなくフレーム全体を拡大するため、`4K`におけるワイド画像の長辺は4096ピクセルを大幅に超えます。実測値であり、利用可能な両モデルで同一です。
| `image_size` | `1:1` | `21:9` | おおよそのピクセル数 |
| ------------ | ----------- | ----------- | ---------- |
| `1K` | 1024 × 1024 | 1584 × 672 | 1 MP |
| `2K` | 2048 × 2048 | — | 4 MP |
| `4K` | 4096 × 4096 | 6336 × 2688 | 17 MP |
ファイルサイズもこれに応じて増加します。`1K`では約0.4～0.7 MB、`2K`では2.4～3.0 MB、`4K`では7.5～8.2 MBです。出力は常に、C2PAコンテンツ認証情報マニフェストを含むJPEGです。
## アスペクト比
10個の値を受け付けます。`1K`の`gemini-3-pro-image`で測定したピクセル数:
| 比率 | ピクセル数 | 比率 | ピクセル数 |
| ----- | ----------- | ------ | ---------- |
| `1:1` | 1024 × 1024 | `4:5` | 928 × 1152 |
| `3:2` | 1264 × 848 | `5:4` | 1152 × 928 |
| `2:3` | 848 × 1264 | `9:16` | 768 × 1376 |
| `4:3` | 1200 × 896 | `16:9` | 1376 × 768 |
| `3:4` | 896 × 1200 | `21:9` | 1584 × 672 |
すべての比率は、公称値の1パーセント以内に収まりました。`aspect_ratio`を省略すると、テキスト
promptでは1024 × 1024になります。一方、`images`を渡すと、出力は
ソース画像の形状に従います。
## 編集とコンポジション
`images`に参照画像を渡して編集するか、それらを元にコンポジションします。各エントリは
`https` URL または base64 データ URI のいずれかです。data URI プレフィックスのない bare base64 文字列は拒否され、
通常の `http` も同様に拒否されます。
```json theme={null}
{
"model": "gemini-3-pro-image",
"input": {
"prompt": "place the leaf from the second image leaning against the mug from the first",
"images": [
"https://your-bucket.example/mug.jpg",
"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
]
}
}
```
1 回の呼び出しで両方の形式を自由に組み合わせることができ、`aspect_ratio`、`image_size`、`n`も
すべて引き続き適用されます。`4K`での編集は、実際に 4096 × 4096 で返されます。
URL はタスクの受け付け後に**サーバー側でフェッチされる**ため、無効な参照の場合は
`400`ではなく `failed`タスクが生成されます。2 つの失敗コードによって、どのレイヤーで処理が
中断されたかを確認できます。
| 渡したもの | `error.code` | 失敗までの時間 |
| --------------------------- | ------------------- | ------- |
| 解決できないホスト、404、または認証が必要な URL | `input_fetch_error` | 1 秒未満 |
| 到達可能だが、画像ではないもの（HTML、JSON） | `upstream_error` | 約 4 秒 |
どちらもモデル処理の前に失敗するため、すばやく、低コストで再試行できます。
## レイテンシ
非同期の数値は同時実行数12で30タスクを実行した結果で、同期の数値は単一呼び出しによるものです。これらはサービスレベル保証ではなく、桁の目安としてお考えください。
| | Nano Banana Pro | Nano Banana 2 |
| -------------- | --------------- | ------------- |
| 非同期送信呼び出し | 約0.9秒 | 約0.9秒 |
| 非同期エンドツーエンド、1K | 平均約29秒 | 平均約20秒 |
| 非同期エンドツーエンド、4K | 約36～40秒 | 約41秒 |
| 同期ラウンドトリップ、1K | 約17秒 | 約13秒 |
非同期では、残りの20～40秒間接続を保持せずに済む代わりに、ラウンドトリップが約0.9秒余分にかかります。負荷下でのキュー時間は0～11秒で、エンドツーエンドの数値にはすでに含まれています。
## 同期サーフェス
利用可能な両方のモデルで3つの同期形式を使用でき、いずれも画像をURLではなくインラインで返します。
| エンドポイント | 画像の場所 |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `POST /v1/images/generations` | `data[0].b64_json`、または `response_format` を `url` に設定した `data[0].url`。`n` は無視されます。1回の呼び出しにつき画像は1枚です。 |
| `POST /v1/chat/completions` | メッセージコンテンツ内のデータURIを含むMarkdown画像 |
| `POST /v1beta/models/{model}:generateContent` | `inlineData` パート内の `candidates[0].content.parts[]` |
Geminiネイティブ形式では、位置によって `parts` をインデックス指定しないでください。これは異種配列であり、長さと順序は保証されません。テキストパートが先に来る場合があり、複雑な編集では複数の下書き画像が返されます。`inlineData` を持つエントリをフィルタリングして **最後の** エントリを取得し、ファイル拡張子を仮定するのではなく、レスポンスから `mimeType` を読み取ってください。
## 次のステップ
このページから実際のリクエストを送信し、タスクの実行を確認します。
エンベロープ、ポーリングループ、コールバック、エラーテーブルについて説明します。