> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini 3.1 Flash Image VIP 画像生成

> Gemini 3.1 Flash Image VIP はテキストから画像生成と画像から画像生成に対応し、参考画像は最大 14 枚です。

> [!NOTE]
>
> **中国本土のユーザー向け：** 中国本土のユーザーは `https://toapis.cn` を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では `https://toapis.com` を `https://toapis.cn` に置き換えてください。

## バージョンの選択

| バージョン | 参考画像の上限 | 用途 |
| - | - | - |
| [通常版](https://docs.toapis.com/docs/ja/api-reference/images/gemini-3.1-flash/generation.md) | 6 枚 | テキストから画像生成と少量の参考画像編集 |
| [VIP](https://docs.toapis.com/docs/ja/api-reference/images/gemini-3.1-flash-vip/generation.md) | 14 枚 | より多くの参考画像が必要な編集と組み合わせ |
| [Official](https://docs.toapis.com/docs/ja/api-reference/images/gemini-3.1-flash-official/generation.md) | 14 枚 | ネイティブの生成パラメータ制御が必要な場合 |

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

## 現在のバージョン

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

> [!WARNING]
>
> `image_urls` は画像 URL のみに対応し、base64 を直接受け取りません。先に [Upload 画像API](https://docs.toapis.com/docs/ja/api-reference/uploads/images.md) でアクセス可能な URL を取得してください。

## Authorizations

**Authorization** `string` *required*

`Bearer YOUR_API_KEY` で認証します。API Key は [コンソール](https://toapis.com/dashboard/tokens) で作成できます。

## Body

**model** `string` *required* (default: gemini-3.1-flash-image-preview-vip)

`gemini-3.1-flash-image-preview-vip` に固定です。通常のモデル名やその他のエイリアスが、この VIP ルートに自動で切り替わることはありません。

**prompt** `string` *required*

生成または編集する画像を説明します。複数の参考画像を指定する場合は、リストの順序に従って各画像の用途を説明できます。

**size** `string`

画像のアスペクト比。例：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`。

**n** `integer` (default: 1)

1 リクエストにつき画像を 1 枚生成します。数値の `1` を使用し、文字列の `"1"` は使用しないでください。

**image\_urls** `object[]`

省略可能な参考画像のリストで、最大 14 枚です。テキストから画像生成ではこのフィールドを省略します。
先に [Upload 画像API](https://docs.toapis.com/docs/ja/api-reference/uploads/images.md) でアクセス可能な画像 URL を取得し、base64 を直接渡さないでください。

**参考画像のフィールド**

**url** `string` *required*

公開アクセス可能な HTTP または HTTPS の画像 URL。

例：`[{"url": "https://example.com/reference-1.png"}, {"url": "https://example.com/reference-2.png"}]`。
14 枚は入力参考画像の上限であり、1 回のリクエストで出力される画像の枚数ではありません。

**metadata** `object`

**出力解像度**

**resolution** `string` (default: 1K)

`1K`、`2K`、`4K` に対応します。省略時は `1K` を使用します。

**grounding** `string` (default: none)

Google 検索によるグラウンディング。有効にすると、モデルは生成前に Google を検索し、結果の `grounding_metadata` に引用元が含まれる場合があります。

オプション：

* `none` - 無効（デフォルト）
* `web` - ウェブ検索
* `image` - 画像検索
* `web_image` - ウェブ＋画像検索

実際に実行された検索クエリごとに課金され、\$0.014/クエリです。リクエスト送信時に最大 4 クエリ分のデポジットが予約され、未使用分は決済時に返金されます。

## リクエスト例

```bash theme={null}
curl --request POST 'https://toapis.com/v1/images/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-image-preview-vip",
    "prompt": "Keep the person from the first image, adopt the background and color palette from the second image, and generate a natural-light portrait.",
    "size": "1:1",
    "n": 1,
    "image_urls": [
      {"url": "https://example.com/reference-1.png"},
      {"url": "https://example.com/reference-2.png"}
    ],
    "metadata": {"resolution": "1K"}
  }'
```

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

## 結果の照会

送信レスポンスの `id` がタスク ID です。[画像タスクのステータス取得](https://docs.toapis.com/docs/ja/api-reference/tasks/image-status.md) でステータスと最終的な画像を取得します。
タスクの照会と [Webhook コールバック](https://docs.toapis.com/docs/ja/api-reference/webhooks/task-webhooks.md) は、共通の非同期画像エンドポイントの規約に従います。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.