Gemini 图片 API

支持官方和特惠分组。使用对应分组的 API Key；两组请求使用相同的公开模型 ID，请原样填写，不添加后缀或 group 字段。

支持的协议

使用 JSON POST /v1/images/generations 生成图片，使用 POST /v1/images/edits（multipart/form-data）上传文件编辑。提交返回 202 Accepted 和任务 id，之后轮询 GET /v1/tasks/{id}，直到 completed 或 failed。202 不表示已经出图。

本系列使用 Images + 异步任务，不支持通过 /v1/chat/completions 或 /v1/responses 生成图片。完整示例见提交并轮询。

模型与参数

size 是宽高比，例如 1:1、16:9；resolution 是分辨率，缺省为 1K。2.5 的提示词最多 1000 字符，其他两款最多 4000 字符。每次生成一张图片，n 传 1 或省略。

生成图片

先将 APIPOOL_API_KEY 设置为自己的 Key，再运行示例：

APIPOOL_ENDPOINT="https://app.apipool.dev"

curl "$APIPOOL_ENDPOINT/v1/images/generations" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "A blue ceramic cup on a white table",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
}'

编辑图片

上传本地 PNG、JPEG 或 WebP 文件；把 source.png 换成实际文件路径：

curl "https://app.apipool.dev/v1/images/edits" \
  -H "Authorization: Bearer $APIPOOL_API_KEY" \
  -F "model=gemini-3.1-flash-image-preview" \
  -F "prompt=Change the cup to green" \
  -F "image=@./source.png" \
  -F "size=1:1" \
  -F "resolution=1K" \
  -F "n=1"

多张参考图可重复 -F "image=@./second.png"，不得超过模型上限。 已有可公开下载的参考图时，也可在同一个 JSON 生成接口中传 image_urls：

{
  "model": "gemini-3.1-flash-image-preview",
  "prompt": "Change the cup to green",
  "size": "1:1",
  "resolution": "1K",
  "n": 1,
  "image_urls": ["https://your-cdn.example/source.png"]
}

把示例 URL 换成服务端可访问的真实地址。临时隧道失效、DNS 解析失败或下载超时 会导致任务失败；不要使用仅自己的浏览器可访问的本机或登录态地址。

查询与获取结果

保存提交响应中的 id（例如 imgtask_01...），使用提交时同一个 Key 查询：

TASK_ID="imgtask_01..."
curl "https://app.apipool.dev/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIPOOL_API_KEY"

submitted、submission_unknown、processing、meter_pending 时继续查询； completed 时读取 data[].url 并在有效期内下载；failed 时读取 error。 不要因为尚未完成就重复提交。完整状态、超时处理和可运行轮询示例见 图片异步任务。

范围与计费

Google 原厂原生生图协议与本站接口不同。本页的独立图片模型使用 Images 异步协议；本站没有开放这些模型的 Gemini 原生入口，也不支持通过 Chat Completions / Responses 生成图片。

计费取决于 Key 所属分组和所选模型，见所选分组的模型与价格。不要把官方组与特惠组的计价方式混用。