Nano Banana Pro 图像生成

POST

/v1/images/generations

Nano Banana Pro 同时支持文生图和图生图：可以根据提示词从零生成图像，也可以使用 1–8 张参考图完成编辑与多参考图融合。

• 支持 auto 与 10 种常用宽高比。
• 支持 1k、2k、4k 三档输出。
• 参考图可使用公网 HTTPS URL 或 PNG、JPEG、WebP base64 data URI。
• 接口同步返回统一的 PNG base64。

• 每次请求固定生成 1 张图像。
• 最长等待 180 秒，客户端超时应设置得更长。

模型

请求体中的 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

要调用的模型 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

响应

生成成功。返回一张已统一为 PNG 的图像。

Content-Type

application/json

{

  

"created": 1787270400,

  

"data": [

  

  

{

  

  

  

"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."

  

  

}

  

],

  

"output_format": "png",

  

"size": "1024x1024"

}

POST

/v1/images/generations

试验场

授权

bearerAuth

主体

示例

保存返回的图像

成功响应中的 data[0].b64_json 是不带 data URI 前缀的 PNG base64。下面的 Python 示例会把它保存为 output.png：

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=200,
)
response.raise_for_status()

with open("output.png", "wb") as image_file:
    image_file.write(base64.b64decode(response.json()["data"][0]["b64_json"]))

NOTE

这是同步接口。客户端超时应大于服务端最长 180 秒的等待时间；不需要查询任务状态。