GeminiNano Banana Pro Preview
Nano Banana Pro Preview · 画像生成
画像 / Gemini / Nano Banana Pro Preview / 画像生成
POST
/v1/images/generationsリクエストパラメータ
Authorization
Header に Authorization を追加し、値は Bearer の後に API キーを続けます。
Authorization: Bearer ****************
Header パラメータ
Content-Typestring任意
application/json
Acceptstring任意
application/json
Body パラメータapplication/json必須
modelstring必須
モデル ID。`gemini-3-pro-image-preview` に固定
promptstring必須
画像の説明
ninteger任意
生成枚数、デフォルト `1`
sizestring任意
解像度、例 `1024x1024`
qualitystring任意
品質ティア（モデルが対応する場合）
response_formatstring任意
返却形式。`url` は対応するモデル（DALL-E など）のみ有効。OpenAI gpt-image は常に `b64_json` を返し、このフィールドを無視します。
output_formatstring任意
出力画像のエンコード形式（png / jpeg / webp）。OpenAI gpt-image モデルに適用。
output_compressioninteger任意
圧縮レベル 0–100。jpeg / webp のみ有効。
backgroundstring任意
背景タイプ（transparent / opaque / auto）。transparent は png または webp が必要。
moderationstring任意
モデレーション強度（auto / low）。上流でも審査されます。
userstring任意
不正利用検出のため上流へ転送する任意のエンドユーザー識別子。
例
{ "model": "gemini-3-pro-image-preview", "prompt": "雪の中を走るゴールデンレトリバー", "n": 1, "size": "1024x1024", "response_format": "b64_json"}リクエストコード例
curl https://api.hotrouter.ai/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gemini-3-pro-image-preview", "prompt": "雪の中を走るゴールデンレトリバー", "n": 1, "size": "1024x1024", "response_format": "b64_json" }'レスポンス
200 · 成功
createdinteger任意
作成タイムスタンプ（秒）
dataarray[object]必須
生成された画像
例
{ "created": 1730000000, "data": [ { "b64_json": "<base64>" } ]}