Gemini Images API
Gemini Images 通过与 GPT-Image 相同的 Images API、异步任务、资源中心和 Webhook 协议提供服务。业务代码只需切换模型，并在需要时传入 provider_options.google。
支持的模型：
| 模型 | 文生图 | 无 Mask 编辑 | 同步 URL/Base64 | 异步与 Webhook |
|---|---|---|---|---|
gemini-3.1-flash-image | 支持 | 支持 | 支持 | 支持 |
gemini-3-pro-image-count | 支持 | 支持 | 支持 | 支持 |
与旧 Gemini 图片接口的区别
本页介绍统一 Images API。Gemini 原生 generateContent 和 OpenAI Chat Base64 接入仍然保留，详见旧版 Gemini 图片文档。
接口
| 能力 | 方法与路径 | 鉴权 |
|---|---|---|
| 同步生成 | POST /v1/images/generations | 模型 API Token，sk-... |
| 同步编辑 | POST /v1/images/edits | 模型 API Token，sk-... |
| 创建异步任务 | POST /v1/image/tasks | 模型 API Token，sk-... |
| 查询异步任务 | GET /v1/image/tasks/{task_id} | 资源 API Key，ak_... |
| 查询生成资源 | GET /v1/assets | 资源 API Key，ak_... |
| 异步完成通知 | 账号级 Webhook | 接收端校验 wk-... |
快速开始
bash
export SUPERTOKEN_BASE_URL="https://api.supertoken.cc"
export SUPERTOKEN_KEY="YOUR_MODEL_API_TOKEN"
export IMAGE_MODEL="gemini-3.1-flash-image"
curl -sS "$SUPERTOKEN_BASE_URL/v1/images/generations" \
-H "Authorization: Bearer $SUPERTOKEN_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$IMAGE_MODEL"'",
"prompt": "极简产品摄影，一只透明玻璃杯放在黑色石材桌面上",
"n": 1,
"aspect_ratio": "1:1",
"resolution": "1K",
"quality": "auto",
"output_format": "png"
}' | jq .同步默认返回 data[].url。设置 response_format=b64_json 时返回临时 Base64 结果；异步任务始终返回归档后的 URL，并进入资源中心。
统一协议
- 同步、异步、资源、幂等和 Webhook 端点与 GPT-Image 相同。
- Webhook 事件仍为
image.task.succeeded和image.task.failed。 - 上游直接返回 HTTP(S) 图片 URL 时原样使用；上游返回 Base64 时由服务上传至对象存储。
- 固定价格模型按次结算，按量模型根据终态
usage多退少补；失败任务退回预扣额度。 usage在同步响应、异步查询、消费日志和 Webhook 中使用同一归一化结构。
Gemini 限制
- 每次只能生成一张图片，
n或output.count必须为1。 - 编辑支持一张或多张参考图，但不支持 Mask。
quality只能省略或使用auto，输出格式只能省略或使用png。- Flash 支持
512/0.5K/1K/2K/4K，Pro 支持1K/2K/4K；默认保持1:1/1K。 aspect_ratio和resolution是公开输出参数；采样、thinking、安全策略等高级参数放在provider_options.google。- 旧
size映射和provider_options.google.generationConfig.imageConfig继续兼容，但不能与对应公开字段重复控制。