Skip to main content
POST
モデル名の互換性に関する注意gemini-3.1-flash-lite-image は別名 nano-banana-2-lite に対応し、gemini-3.1-flash-lite-image-ext は別名 nano-banana-2-lite-ext に対応します。各名称とその別名は等価であり、互換的に使用できます。

認証

string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:

Body

string
デフォルト:"gemini-3.1-flash-lite-image"
必須
画像生成モデル名以下のモデル名をサポート:
  • gemini-3.1-flash-lite-image(Nano Banana Lite、別名 nano-banana-2-lite に対応)
  • gemini-3.1-flash-lite-image-ext(別名 nano-banana-2-lite-ext に対応)
2つはパラメータと制約が同じです(1K のみ、google_search / official_fallback 非対応、参照画像は最大14枚)。いずれも -official バリアントはなく、official_fallback フォールバックパラメータもサポートしません。課金は各チャネルの管理画面設定に従います。別名 nano-banana-2-litegemini-3.1-flash-lite-image に対応)、nano-banana-2-lite-extgemini-3.1-flash-lite-image-ext に対応)は、それぞれの元の名称と等価であり、互換的に使用できます。
string
必須
画像生成のテキスト説明
string
画像のアスペクト比サポートされる比率:
  • auto - アスペクト比を自動選択
  • 1:1 - 正方形、アバター、SNS
  • 3:2 / 2:3 - 標準写真
  • 4:3 / 3:4 - 従来のディスプレイ比率
  • 16:9 / 9:16 - ワイドスクリーン/縦型動画カバー
  • 5:4 / 4:5 - Instagram画像
  • 21:9 - ウルトラワイドバナー
テキストから画像生成では、sizeauto の場合、デフォルトは 1:1 または 16:9 です。画像から画像生成では、上流の返却比率に従います。(比率の指定を推奨します)
string
デフォルト:"1K"
出力画像解像度サポートされる値:
  • 1K - 約1024px、標準解像度(Lite はこの段階のみサポート
Lite は 1K のみサポートします。2K / 4K / 0.5K を渡すとサイレントに 1K へダウングレードされ、エラーにはならず、実際に高解像度で出力されることもありません。フロントエンド UI で解像度オプションを公開する必要はありません。
integer
デフォルト:"1"
生成する画像の数範囲:1 ~ 4、デフォルト 1n>1 の場合、バックエンドは上流へ複数回リクエストを並行して送信し、実際に成功した枚数に基づいて課金します。フロントエンドでは 1 を固定で渡すことを推奨します(1枚ずつ進捗を表示でき、課金もより直感的です)。⚠️ 注意: 数値のみ入力してください(例:1)。引用符を使用するとエラーが発生します
array
画像から画像生成用の参照画像URLリスト2つの形式をサポート:1. 完全な画像URLアドレス
  • 公開アクセス可能な画像URL(http:// または https://)
  • 例:https://example.com/image.jpg
2. Base64エンコード形式
  • 完全なData URI形式を使用する必要があります
  • 形式:data:image/{形式};base64,{base64データ}
  • サポートされる画像形式:jpeg、png、webp
  • 例:data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 注意:data:image/jpeg;base64, プレフィックスを含める必要があります
制限:
  • 最大 14枚 の参照画像(推奨:最大10枚のオブジェクト参照 + 4枚のキャラクター参照)
  • 1枚あたり10MB以下
  • 対応形式:jpeg、png、webp
string
タスクコールバックアドレス(base)タスクの成功 / 失敗時に、本プラットフォームは webhook + /callback へコールバックします(上流へは転送しません)。このパラメータを渡すとポーリングを大幅に削減できますが、フォールバックとしてポーリングを残すことを推奨します。
Lite 利用時のポイント
  • google_search / google_image_search はサポートされません:Lite は Developer API の interactions エンドポイントを利用しますが、上流が Search ツールを開放していない(“Search as tool is not enabled for this model” を返します)ため、プラットフォームのアダプターもこのパラメータを下流に送りません。渡してもエラーにはならず通常どおり画像は生成されますが、検索強化の効果は一切ありません。検索強化が必要な場合は gemini-3.1-flash-image-preview を使用してください。
  • mask_url による部分的な再描画はサポートしません(Gemini シリーズは aspect ratio + 参照画像で処理し、マスクは使用しません)。
  • token に基づいて課金(flash/pro の枚数固定価格とは異なります):入力は約 0.25/百万token、画像出力は約0.25/百万 token、画像出力は約 30/百万 token、1K の1枚 ≈ 1120 output token ≈ $0.0336/枚。実際の価格は管理画面の倍率設定に従います。
  • 生成されるすべての画像には Google SynthID の不可視ウォーターマークが含まれます(上流の動作であり、無効化できません)。

レスポンス

integer
レスポンスステータスコード
array
レスポンスデータ配列