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

# Gemini 3.1 Flash 图像生成 API | Search 增强接口

> 使用 Gemini 3.1 Flash 图像模型生成图片，支持极端宽高比、Google Search 搜索增强及最高 4K 分辨率输出。

通过 即刻API 统一网关调用 Google Gemini 3.1 Flash 图像生成模型。提交生成请求后返回同步结果。Gemini 3.1 Flash 图像模型支持文生图、图生图，最多 4张参考图，并集成 **Google Search 搜索增强**，可生成更贴合真实世界信息的图像。支持包括 `1:4`、`8:1` 在内的极端宽高比。

## 请求参数

<ParamField body="model" default="gemini-3.1-flash-image-preview" type="string" required>
  图像生成模型名称。

  示例：`"gemini-3.1-flash-image"`
</ParamField>

<ParamField body="prompt" type="string" required>
  图像生成的文本描述。

  示例：`"赛博朋克风格的城市夜景，霓虹灯闪烁"`
</ParamField>

<ParamField body="image_urls" type="object[]">
  参考图像 URL 列表，用于图生图或图像编辑。

  **限制：**

  * 最多 4 张图片
  * 单张图片不得超过 2MB

  支持格式：.jpeg、.jpg、.png、.webp

  <ParamField body="size" type="string">
    输出图像尺寸。建议始终传入具体像素值，实际输出结果以 `size` 为准。

    支持的尺寸如下：

    **1K**

    * `1024x1024`：1:1
    * `1360x768`：16:9
    * `768x1360`：9:16
    * `1152x864`：4:3
    * `864x1152`：3:4

    **2K**

    * `2048x2048`：1:1
    * `2752x1536`：16:9
    * `1536x2752`：9:16
    * `2048x1536`：4:3
    * `1536x2048`：3:4

    **4K**

    * `4096x4096`：1:1
    * `5504x3072`：16:9
    * `3072x5504`：9:16
    * `4096x3072`：4:3
    * `3072x4096`：3:4

    说明：

    * 建议优先使用上面列出的标准尺寸
    * 如未显式传入 `size`，默认输出行为可能随网关实现调整
  </ParamField>

  <ParamField body="response_format" default="b64_json" type="string">
    响应格式。建议使用 `b64_json`，接口将直接返回图片 Base64 数据。
  </ParamField>

  <ParamField body="tools" type="object[]">
    搜索增强工具配置。用于启用 Google 搜索增强。
  </ParamField>

  <ParamField body="tools[].type" default="google_search" type="string">
    工具类型。当前固定为 `google_search`。
  </ParamField>

  <ParamField body="tools[].search_types" type="string[]">
    搜索类型，可选值：

    * `web_search`
    * `image_search`

    如需同时启用文字搜索和图片搜索，可传：\
    `["web_search", "image_search"]`

    <ParamField body="n" default="1" type="integer">
      生成数量

      说明：

      * 建议固定传 `1`
      * 当前接口实际返回通常为单张图片结果，响应体中对应 `data[0]`
    </ParamField>
  </ParamField>
</ParamField>

## 请求示例

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://geekapis.com/v1/images/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "gemini-3.1-flash-image",
      "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
      "size": "2752x1536",
      "response_format": "b64_json",
      "n": 1
    }'
  ```

  ```bash cURL (图生图) theme={null}
  curl --request POST \
    --url https://geekapis.com/v1/images/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "gemini-3.1-flash-image",
      "prompt": "保持角色风格，将背景替换为科幻太空站",
      "size": "1024x1024",
      "response_format": "b64_json",
      "n": 1,
      "image_urls": [
        {
          "url": "https://example.com/character.jpg"
        }
      ]
    }'
  ```

  ```bash cURL (Google 搜索增强) theme={null}
  curl --request POST \
    --url https://geekapis.com/v1/images/generations \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "gemini-3.1-flash-image",
      "prompt": "2025年最新款 iPhone 的产品展示图",
      "size": "1024x1024",
      "response_format": "b64_json",
      "n": 1,
      "tools": [
        {
          "type": "google_search",
          "search_types": ["web_search", "image_search"]
        }
      ]
    }'
  ```
</CodeGroup>

## 响应示例

```json theme={null}
{{
  "created": 1782383890,
  "model": "firefly-nano-banana2-2k-16x9",
  "data": [
    {
      "revised_prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAACsAAAA..."
    }
  ]
}
```