开发者 API

用 Nano Banana API 构建

与工作台同源的引擎，通过简洁的 REST API 调用——创建批次、轮询结果、查询积分与历史。

API 访问随任意 Pro 订阅开放

订阅 Pro 或 Premium 即可获得 API key，并解锁 200 次/分钟的速率限制；无订阅时试用访问为 20 次/分钟。

查看定价

你的 API key

演示模式

API key

nb_test_demo_key_xxx

这是仅用于版面预览的占位 key，无法调用 API。真实 key 会在 API 访问开通后从你的账号签发。

开发者 API

端点

基础路径 /api/v1。请求与响应均为 JSON；错误遵循稳定的机器可读模型。

方法	路径	说明
POST	/api/v1/batches	创建生成批次（提示词、宽高比、分辨率、幂等键）。
GET	/api/v1/batches/:id	轮询批次状态与每个槽位的结果。
POST	/api/v1/batches/:id/slots/:slotId/retry	重试失败、超时或被拦截的槽位。
GET	/api/v1/credits	查询双轨积分余额。
GET	/api/v1/history	按新到旧列出历史批次，游标分页。

开发者 API

速率限制

套餐	每分钟请求数
免费档	20
Pro / Premium	200

超过限制的请求会收到 HTTP 429，并附带 Retry-After 提示。

开发者 API

用 curl 创建批次

bash

curl -X POST https://nanobananalite.org/api/v1/batches \
  -H "Authorization: Bearer $NB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompts": ["a banana astronaut planting a flag on the moon"],
    "referenceImages": [],
    "aspectRatio": "1:1",
    "resolution": "2K",
    "outputsPerPrompt": 1,
    "idempotencyKey": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  }'