Skip to main content
POST
Gemini 3.1 Flash Image VIP 画像生成
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.comhttps://toapis.cn に置き換えてください。

バージョンの選択

参考画像の数は入力画像の合計枚数を指し、出力画像の枚数を表すものではありません。3 つのバージョンは異なるモデル ID を使用するため、それぞれのページのパラメータと例に従って呼び出してください。

現在のバージョン

model: "gemini-3.1-flash-image-preview-vip" で VIP を選択すると、テキストから画像生成と、最大 14 枚の参考画像を使った画像から画像生成または画像編集に対応します。 7 から 14 枚の参考画像が必要な編集や複数画像の組み合わせに適しています。複数画像のリクエストでは、リストの順序に従って各画像の用途を説明できます。 リクエストは非同期で実行され、送信に成功したらタスク ID で結果を照会します。
image_urls は画像 URL のみに対応し、base64 を直接受け取りません。先に Upload 画像API でアクセス可能な URL を取得してください。

Authorizations

string
必須
Bearer YOUR_API_KEY で認証します。API Key は コンソール で作成できます。

Body

string
デフォルト:"gemini-3.1-flash-image-preview-vip"
必須
gemini-3.1-flash-image-preview-vip に固定です。通常のモデル名やその他のエイリアスが、この VIP ルートに自動で切り替わることはありません。
string
必須
生成または編集する画像を説明します。複数の参考画像を指定する場合は、リストの順序に従って各画像の用途を説明できます。
string
画像のアスペクト比。例:1:12:33:23:44:34:55:49:1616:921:9
integer
デフォルト:1
1 リクエストにつき画像を 1 枚生成します。数値の 1 を使用し、文字列の "1" は使用しないでください。
object[]
省略可能な参考画像のリストで、最大 14 枚です。テキストから画像生成ではこのフィールドを省略します。 先に Upload 画像API でアクセス可能な画像 URL を取得し、base64 を直接渡さないでください。例:[{"url": "https://example.com/reference-1.png"}, {"url": "https://example.com/reference-2.png"}]。 14 枚は入力参考画像の上限であり、1 回のリクエストで出力される画像の枚数ではありません。
object

リクエスト例

例の URL は、実際にアクセス可能な参考画像のアドレスに置き換えてください。参考画像はさらに追加できますが、リストの合計枚数は 14 を超えてはいけません。 テキストから画像生成のリクエストでは、image_urls を削除してプロンプトを変更するだけです。

結果の照会

送信レスポンスの id がタスク ID です。画像タスクのステータス取得 でステータスと最終的な画像を取得します。 タスクの照会と Webhook コールバック は、共通の非同期画像エンドポイントの規約に従います。