主题
Nano Banana Pro 图像生成
POST
/v1/images/generations
🤖 本页是给 AI Agent 读的接口文档
人类用户只需按「如何使用」中的方法教会 AI 怎么用。
Nano Banana Pro 同时支持文生图和图生图:可以根据提示词从零生成图像,也可以使用 1–8 张参考图完成编辑与多参考图融合。
- 支持
auto与 10 种常用宽高比。 - 支持
1k、2k、4k三档输出。 - 参考图可使用公网 HTTPS URL 或 PNG、JPEG、WebP base64 data URI。
- 接口同步返回原始图片字节的 Base64。
- 每次请求固定生成 1 张图像。
- 这是同步接口。客户端读取超时请设为 480 秒;服务端实际等待上限以当前部署配置为准。
模型
请求体中的 model 固定填写下面的模型 ID。
gemini-3-pro-image价格
| 分辨率 | 单张售价 |
|---|---|
1k | ¥0.25 / $0.0368 |
2k | ¥0.25 / $0.0368 |
4k | ¥0.35 / $0.0515 |
文生图与图生图同档同价,参考图不额外收费;每次固定输出 1 张,仅对成功生成的图像计费。
认证
使用 ClawPower API Key 进行 Bearer 认证,并在请求头中传入:
Authorization: Bearer <CLAWPOWER_API_KEY>类型 HTTP (bearer)
请求体
application/json模式
请求体
application/json
要调用的模型 ID,固定填写 gemini-3-pro-image,不接受产品别名或其他模型名称。
有效值
"gemini-3-pro-image"图像生成或编辑说明。必须是非空 UTF-8 字符串,最长 20000 个字符。
最小长度
1最大长度
20000输出图像的宽高比。文生图省略时默认为 1:1;图生图省略时默认为 auto。
有效值
"auto""1:1""2:3""3:2""3:4""4:3""4:5""5:4""9:16""16:9""21:9"输出分辨率档位,省略时默认为 1k;取值大小写不敏感。
有效值
"1k""2k""4k"默认
"1k"参考图数组。省略时执行文生图;传入时执行图生图。支持公网 HTTPS URL 或 PNG、JPEG、WebP base64 data URI;单张最大 10 MB,所有参考图原始数据合计最大 64 MB。
最小项数
1最大项数
8响应
生成成功。返回一张保留原始字节的图像。
application/json
JSON "created": 1787270400, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ], "output_format": "png", "size": "1024x1024"
{
}
保存返回的图像
成功响应中的 data[0].b64_json 是不带 data URI 前缀的原始图片 Base64。下面的 Python 示例根据返回的 output_format 选择文件扩展名:
python
import base64
import requests
response = requests.post(
"https://api.clawpowerai.com/v1/images/generations",
headers={
"Authorization": "Bearer <CLAWPOWER_API_KEY>",
"Content-Type": "application/json",
},
json={
"model": "gemini-3-pro-image",
"prompt": "高端香水产品广告,柔和棚拍光,瓶身上有清晰的中文标题",
"size": "4:5",
"resolution": "2k",
},
timeout=480,
)
response.raise_for_status()
result = response.json()
extensions = {"png": ".png", "jpeg": ".jpg", "webp": ".webp"}
filename = "output" + extensions[result["output_format"]]
with open(filename, "wb") as image_file:
image_file.write(base64.b64decode(result["data"][0]["b64_json"], validate=True))NOTE
这是同步接口。客户端读取超时请设为 480 秒;服务端实际等待上限以当前部署配置为准;不需要查询任务状态。
