Nano Banana 2.1
ID:
google/nano-banana-2.1Google 推出的 Nano Banana 2.1 图像生成 API —— Gemini Flash 图像模型的升级版,视觉设计、编辑与主体一致性全面提升,最高 4K,支持 14 张参考图。
Nano Banana 2.1Gemini ImageGoogle图像编辑4K
概览
Google 推出的 Nano Banana 2.1 图像生成 API —— Gemini Flash 图像模型的升级版,视觉设计、编辑与主体一致性全面提升,最高 4K,支持 14 张参考图。
认证
所有 API 请求需要通过 Authorization 请求头以 Bearer 方式传递有效的 API 密钥。
快速开始
凭证
设置 RUNBASE_API_KEY 环境变量。
Shell
export RUNBASE_API_KEY=your-api-key创建运行
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/nano-banana-2.1",
"input": {
"prompt": "一张陶瓷台灯的电影级产品照片"
}
}'运行记录
运行以异步方式处理。提交请求后,轮询获取结果。
创建运行
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/nano-banana-2.1",
"input": { "prompt": "一张陶瓷台灯的电影级产品照片" }
}'获取运行状态
Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"获取结果
轮询状态接口,直到 status 为 "succeeded",然后从响应中读取 output.urls。
输入 Schema
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 必填 | Prompt最多 20000 个字符 |
| aspect_ratio | string | 可选 | Aspect ratio选项: 1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto默认值:1:1 |
| resolution | string | 可选 | Resolution选项: 1K2K4K默认值:1K |
| image_urls | string[] | 可选 | Reference images最多 14 张图片 |
输出 Schema
| 字段 | 类型 | 描述 |
|---|---|---|
| urls | string[] | 生成的输出 URL |
错误
API 使用标准 HTTP 状态码表示成功或失败。
| 状态码 | 描述 |
|---|---|
| 400 | Invalid request - missing or malformed parameters |
| 401 | Authentication failed - missing or invalid API key |
| 402 | Insufficient credits |
| 403 | Forbidden - IP not allowed, account banned, or API key credit limit exceeded |
| 404 | Run not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |

