图像生成 nano-banana
概览
- 请求方法:
POST - 路径:
/v1/images/generations
认证
- 使用 HTTP Bearer Token,示例:
Authorization: Bearer sk-xxxxx
请求参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 是 | 文本描述,最大 32768 Tokens |
| model | string | 是 | 如 nano-banana / gemini-3.1-flash-image-preview / gemini-2.5-flash-image |
| response_format | string | 否 | b64_json/url |
| size | string | 否 | 例如 2:3, 4K 等 |
| aspect_ratio | string | 否 | 比例,如 2:3 (仅 3+ 系列支持) |
请求示例
json
{
"model": "nano-banana",
"prompt": "一张逼真的高分辨率照片,拍摄的是繁忙的城市街道",
"size": "2:3"
}返回示例
json
{
"created": 1725007743,
"data": [{"b64_json": "..."}],
"usage": {"input_tokens": 10, "output_tokens": 20, "total_tokens": 30}
}