Skip to main content
POST
モデル名互換のお知らせ:本エンドポイントはエイリアス nano-banana-pro-ext にも対応しており、gemini-3-pro-image-preview と同等です。両者は互換的に使用でき、効果は同一です。

Authorizations

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

Body

string
デフォルト:"gemini-3-pro-image-preview"
必須
画像生成モデル名サポートされているモデル:
  • gemini-3-pro-image-preview - 標準版(エイリアス nano-banana-pro-ext に対応)
  • gemini-3-pro-image-preview-official - 公式版(エイリアス nano-banana-pro に対応)
例:"gemini-3-pro-image-preview" または "gemini-3-pro-image-preview-official"
旧バージョンの呼び出しとの互換性のため、エイリアス nano-banana-pro-extgemini-3-pro-image-preview に対応)、nano-banana-progemini-3-pro-image-preview-official に対応)は引き続き正常に使用できます。
boolean
デフォルト:"false"
画像タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
画像生成のテキスト説明
string
画像生成のサイズサポートされている形式:
  • 比率:auto1:12:33:23:44:34:55:49:1616:921:9
テキストから画像生成では、sizeauto の場合、デフォルトは 1:1 または 16:9 です。画像から画像生成では、上流の返却比率に従います。(比率の指定を推奨します)
integer
生成する画像の数範囲:1デフォルト:1⚠️ 注意: 純粋な数字(例:1)を入力してください。引用符を付けないでください。エラーになります
string
出力画像の解像度サポートされる値:
  • 1K - 1K解像度(デフォルト)
  • 2K - 2K解像度
  • 4K - 4K解像度
⚠️ 注意: base64形式で4K画像を生成する場合、処理時間が長くなります
boolean
デフォルト:"false"
公式チャネルのフォールバックを使用するかどうか
  • false:使用しない(デフォルト)
  • true:公式チャネルを使用
公式チャネル(gemini-3-pro-image-preview-official)を使用する場合、このパラメータは使用できません。
array
画像から画像への変換や画像編集用の参照画像URLリスト💡 クイック入力(Try itエリア):
  1. 「+ Add an item」をクリックして画像URLを追加
  2. 完全な画像URLアドレスまたはbase64データを入力
制限: 最大14枚の画像

Response

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