Skip to main content
Nano Bananaは、この画像モデル世代におけるGoogleのシリーズ名です。 WideRouterでは、モデルIDは公式のものです — プラットフォーム固有のエイリアスはなく、-previewが付いた名前は受け付けられません。 シリーズ内のすべてのモデルは同じリクエスト形式を使用するため、モデルの切り替えはmodelを1語変更するだけです。

​
シリーズの概要

現在、gemini-2.5-flash-image はどちらのインターフェースでもルーティングされません。非同期 API では送信時に model_not_supported で拒否され、同期エンドポイントでは 料金設定エラーが返されます。公式 ID を検索した際に何も表示されないのではなく、 回答が得られるよう、ここに記載しています。プラットフォーム側の問題が修正され次第、 有効化される予定です。
デフォルトでは Nano Banana 2 を選択してください。すべての解像度で実質的に高速で、同じパラメーターを受け取るため、インテグレーションを変更する必要はありません。画像 1 枚あたり約 10 秒の追加時間に見合う品質向上が必要な場合は、Nano Banana Pro に切り替えてください。

​
パラメーター

すべては input の中に入ります。その周囲のエンベロープ — model、input、 callback_url — については、非同期タスク APIで説明しています。 この5つのフィールドが完全なセットです。input 内のその他のキーは invalid_params で拒否されるため、入力ミスは無視されず、明確に失敗します。
image_size は大文字と小文字を区別します。1K は受け付けられますが、1k は受け付けられません。非同期 API には 512 ティアはなく、自由形式の 1024x1024 形式もありません。

​
解像度ティア

image_sizeは一方の辺を固定するのではなくフレーム全体を拡大するため、4Kにおけるワイド画像の長辺は4096ピクセルを大幅に超えます。実測値であり、利用可能な両モデルで同一です。 ファイルサイズもこれに応じて増加します。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パーセント以内に収まりました。aspect_ratioを省略すると、テキスト promptでは1024 × 1024になります。一方、imagesを渡すと、出力は ソース画像の形状に従います。

​
編集とコンポジション

imagesに参照画像を渡して編集するか、それらを元にコンポジションします。各エントリは https URL または base64 データ URI のいずれかです。data URI プレフィックスのない bare base64 文字列は拒否され、 通常の http も同様に拒否されます。
1 回の呼び出しで両方の形式を自由に組み合わせることができ、aspect_ratio、image_size、nも すべて引き続き適用されます。4Kでの編集は、実際に 4096 × 4096 で返されます。 URL はタスクの受け付け後にサーバー側でフェッチされるため、無効な参照の場合は 400ではなく failedタスクが生成されます。2 つの失敗コードによって、どのレイヤーで処理が 中断されたかを確認できます。 どちらもモデル処理の前に失敗するため、すばやく、低コストで再試行できます。

​
レイテンシ

非同期の数値は同時実行数12で30タスクを実行した結果で、同期の数値は単一呼び出しによるものです。これらはサービスレベル保証ではなく、桁の目安としてお考えください。 非同期では、残りの20～40秒間接続を保持せずに済む代わりに、ラウンドトリップが約0.9秒余分にかかります。負荷下でのキュー時間は0～11秒で、エンドツーエンドの数値にはすでに含まれています。

​
同期サーフェス

利用可能な両方のモデルで3つの同期形式を使用でき、いずれも画像をURLではなくインラインで返します。
Geminiネイティブ形式では、位置によって parts をインデックス指定しないでください。これは異種配列であり、長さと順序は保証されません。テキストパートが先に来る場合があり、複雑な編集では複数の下書き画像が返されます。inlineData を持つエントリをフィルタリングして 最後の エントリを取得し、ファイル拡張子を仮定するのではなく、レスポンスから mimeType を読み取ってください。

​
次のステップ

プレイグラウンド

このページから実際のリクエストを送信し、タスクの実行を確認します。

非同期タスク API

エンベロープ、ポーリングループ、コールバック、エラーテーブルについて説明します。