主题
Nano Banana 2.1 图像生成
POST
/v1/images/generations
🤖 本页是给 AI Agent 读的接口文档
人类用户可按「如何使用」中的方法教会 AI 调用。
Nano Banana 2.1支持文生图和图生图:根据提示词生成图片,或使用1–10张参考图编辑主体、背景与风格。
- 支持14种宽高比及
auto,提供1k、2k、4k三档分辨率。 1:4、4:1、1:8、8:1四种极端比例仅支持1k。- 参考图可使用公网HTTPS URL或PNG、JPEG、WebP的base64 data URI。
- 每次返回一张原始图片,实际格式以响应中的 output_format 为准,结果以
data[0].b64_json提供。
- 每次请求目前固定生成 1 张图像,实际图片格式以响应中的 output_format 为准。
- 这是同步接口。客户端读取超时请设为 480 秒;服务端实际等待上限以当前部署配置为准。
模型
请求体中的 model 固定填写下面的模型 ID。
gemini-nano-banana-2.1价格
| 分辨率 | 单张售价 |
|---|---|
1k | ¥0.20 / $0.0294 |
2k | ¥0.25 / $0.0368 |
4k | ¥0.30 / $0.0441 |
图生图与文生图同档同价,参考图不额外收费;仅对成功生成的图像计费,生成失败的请求不扣费。
认证
使用 ClawPower API Key 进行 Bearer 认证,并在请求头中传入:
Authorization: Bearer <CLAWPOWER_API_KEY>类型 HTTP (bearer)
请求体
application/json模式
请求体
application/json
固定填写公共模型ID gemini-nano-banana-2.1;不接受Nano Banana 2.1品牌名称或其他模型别名。
有效值
"gemini-nano-banana-2.1"图像生成或编辑说明。文生图时描述主体、场景、构图和风格;图生图时说明要保留什么、修改什么。
必须是非空 UTF-8 字符串,去除首尾空白后不能为空,最长 20000 个字符。
最小长度
1最大长度
20000输出宽高比,不是像素尺寸。支持上述14种比例及auto,仅接受冒号写法。文生图省略时默认1:1,图生图省略时默认auto。1:4、4:1、1:8、8:1只允许配合1k;配合2k或4k返回400及invalid_size_resolution。
有效值
"auto""1:1""2:3""3:2""3:4""4:3""4:5""5:4""9:16""16:9""21:9""1:4""4:1""1:8""8:1"输出分辨率及计费档位;省略默认1k。接受1k/2k/4k及对应大写形式。极端比例只支持1k。
有效值
"1k""2k""4k""1K""2K""4K"默认
"1k"参考图数组。省略时为文生图;传入非空数组时为图生图。
- 数量:1–10张,空数组不合法。
- 类型:公网HTTPS URL或PNG、JPEG、WebP的base64 data URI;可以混用。
- 大小:单图不超过10 MiB(10,485,760字节),全部参考图解码或下载后的原始数据合计不超过30,000,000字节。
- 不接受HTTP URL、裸Base64或本地文件路径;不可使用本机、内网或云元数据地址。
最小项数
1最大项数
10响应
生成成功。返回一张保留原始字节的图像。
application/json
JSON "created": 1791504000, "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-nano-banana-2.1",
"prompt": "一张赛博朋克风格的城市夜景海报,霓虹灯倒映在积水的街道上",
"size": "16:9",
"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秒;服务端实际等待上限以当前部署配置为准。
