Nano Banana 2 图像生成

POST

/v1/images/generations

Nano Banana 2 同时支持文生图和图生图：既可以根据提示词从零生成图片，也可以使用 1–14 张参考图完成风格重绘、背景替换和多参考图融合。

• 支持 20 种宽高比，包括 1:4、4:1、1:8、8:1 等极端画幅比例。
• 支持 1k、2k、4k 三档输出，适合从快速预览到高分辨率成图。
• 图生图可混合使用公网 HTTPS 图片与 base64 图片，便于组合不同来源的参考素材。
• ClawPower 会等待生成完成，直接返回统一的 PNG base64。

• 每次请求目前固定生成 1 张图片，输出格式固定为 PNG。
• 这是同步接口，生成、结果下载和格式转换最长等待 180 秒，客户端超时应设置得更长。

模型

请求体中的 model 固定填写下面的模型 ID。

gemini-3.1-flash-image

价格

分辨率	单张售价
1k	¥0.136 / $0.0200
2k	¥0.1904 / $0.0280
4k	¥0.238 / $0.0350

图生图与文生图同档同价，参考图不额外收费；仅对成功生成的图片计费，生成失败的请求不扣费。

认证

使用 ClawPower API Key 进行 Bearer 认证，并在请求头中传入：

Authorization: Bearer <CLAWPOWER_API_KEY>

类型 HTTP (bearer)

请求体

application/json

要调用的模型 ID。Nano Banana 2 对外统一使用 Google 官方稳定版 ID gemini-3.1-flash-image，不支持 nano-banana-2 等其他名称。

有效值"gemini-3.1-flash-image"

图片生成或编辑说明。文生图时描述主体、场景、构图和风格；图生图时说明要保留什么、修改什么。

必须是非空 UTF-8 字符串，去除首尾空白后不能为空，最长 20000 个字符。

最小长度1

最大长度20000

输出图片的宽高比例，不是像素尺寸。横图可选 3:2、4:3、5:4、16:9、2:1、3:1、21:9、4:1、8:1；竖图可选 2:3、3:4、4:5、9:16、1:2、1:3、9:21、1:4、1:8；另支持 1:1 和 auto。

文生图省略时默认为 1:1；图生图省略时默认为 auto。不支持 1024x1024 这类像素尺寸。size 与 resolution 任意组合均可用，无组合限制。

有效值"auto""1:1""3:2""2:3""4:3""3:4""5:4""4:5""16:9""9:16""2:1""1:2""3:1""1:3""21:9""9:21""1:4""4:1""1:8""8:1"

输出分辨率档位，省略时默认为 1k。分辨率越高，价格档位越高。取值大小写不敏感，2K 与 2k 等价。

有效值"1k""2k""4k"

默认"1k"

参考图数组。省略时执行文生图；传入时执行图生图。

• 数量：1–14 张。
• 类型：公网可访问的 HTTPS URL，或 PNG、JPEG、WebP 的 base64 data URI。
• 混用：同一数组内可以同时传 URL 和 base64。
• 大小：单张图片最大 10 MB，所有参考图原始数据合计最大 64 MB。
• URL 安全：最多跟随 5 次安全 HTTPS 重定向，不能访问本机、内网或云元数据地址。

最小项数1

最大项数14

响应

生成成功。返回一张已经验证并统一转换为 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.1-flash-image",
        "prompt": "一张赛博朋克风格的城市夜景海报，霓虹灯倒映在积水的街道上",
        "size": "16:9",
        "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 秒的等待时间；不要按异步任务接口处理，也不需要轮询任务状态。