跳转到主要内容
POST
/
v3
/
gemini-3.1-flash-image-edit
Gemini 3.1 Flash 图片编辑
curl --request POST \
  --url https://api.highwayapi.ai/v3/gemini-3.1-flash-image-edit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "size": "<string>",
  "google": {
    "web_search": true,
    "image_search": true
  },
  "prompt": "<string>",
  "image_urls": [
    {}
  ],
  "aspect_ratio": "<string>",
  "image_base64s": [
    {}
  ],
  "output_format": "<string>"
}
'
{
  "image_urls": [
    {}
  ],
  "grounding_metadata": {}
}
使用 Gemini 3.1 Flash 模型通过自然语言提示词编辑图片。支持 URL 和 Base64 编码的图片作为输入，最多可传入 14 张参考图。

​
请求头

​
Content-Type
string
必填
枚举值: application/json
​
Authorization
string
必填
Bearer 身份验证格式: Bearer {{API 密钥}}。

​
请求体

​
size
string
默认值:"1K"
输出图片的像素尺寸。0.5K（约512px）、1K（约1024px）、2K（约2048px）、4K（约4096px）。默认为 1K可选值：0.5K, 1K, 2K, 4K
​
google
object
Google 搜索选项
​
prompt
string
必填
描述期望图片编辑效果的文本提示词
​
image_urls
array
用于编辑的输入图片 URL 列表，最多支持 14 张参考图数组长度：0 - 14
​
aspect_ratio
string
输出图片的宽高比。支持标准比例和新增的超宽/超长比例（1:4、4:1、1:8、8:1）可选值：1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
​
image_base64s
array
用于编辑的 Base64 编码图片列表。image_urls 和 image_base64s 的总数不超过 14 张数组长度：0 - 14
​
output_format
string
默认值:"image/png"
输出图片的 MIME 类型。支持格式：image/png、image/jpeg。默认为 image/png可选值：image/png, image/jpeg

​
响应信息

​
image_urls
array
必填
编辑后的图片 URL 列表
​
grounding_metadata
object
模型 grounding 元数据。Google 服务端工具（例如搜索）被调用时返回。注意：工具调用取决于 Google。参数启用工具，不一定 100% 触发工具调用。