GeminiNano Banana Pro
Nano Banana Pro · 生成图片
图片 / Gemini / Nano Banana Pro / 生成图片
接口
POST /v1/images/generations
Content-Type: application/json
Authorization: Bearer $API_KEY
OpenAI 兼容的 /v1/images/generations 接口，做文生图。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID，固定为 gemini-3-pro-image |
prompt | string | 是 | 图像描述 |
n | int | 否 | 生成张数，默认 1 |
size | string | 否 | 分辨率，如 1024x1024 |
quality | string | 否 | 质量档位（模型支持时） |
response_format | string | 否 | 返回格式。url 仅对支持的模型（如 DALL-E 系列）生效；OpenAI gpt-image 始终返 b64_json 并忽略此字段。 |
output_format | string | 否 | 输出图像编码格式（png / jpeg / webp）；对 OpenAI gpt-image 模型生效。 |
output_compression | int | 否 | 压缩等级 0–100；仅 jpeg / webp 生效。 |
background | string | 否 | 背景类型（transparent / opaque / auto）；transparent 需搭配 png 或 webp。 |
moderation | string | 否 | 内容审核严格度（auto / low）；仍由上游审核。 |
user | string | 否 | 客户端可选传入的最终用户标识，用于上游滥用检测。 |
以下参数由网关原样透传给上游 OpenAI gpt-image 模型；不支持该字段的模型会忽略或报错。
示例
curl https://api.beerouter.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image",
"prompt": "一只在雪地里奔跑的金毛犬",
"n": 1,
"size": "1024x1024",
"response_format": "b64_json"
}'
响应
{
"created": 1730000000,
"data": [
{ "b64_json": "<base64>" }
]
}
对支持 url 的模型，data[].b64_json 改为 data[].url（链接有效期以上游为准，请尽快保存）。gpt-image 模型始终返回 b64_json。