API Reference
认证
如何使用 NB Pro API 进行认证
API Keys
所有 API 请求都需要使用 API Key 进行认证。您可以在 设置 > API Keys 页面创建和管理您的 API Keys。
需要订阅
API 访问仅对有效订阅用户（Standard 或 Pro 计划）开放。
创建 API Key
- 前往 设置 > API Keys
- 点击 创建 Key
- 为您的 Key 输入一个描述性名称（如 "生产环境"、"开发环境"）
- 复制并安全保存您的 API Key
重要提示
您的 API Key 只会在创建时显示一次。请安全保存 - 您将无法再次查看它。
使用 API Key
在每个请求的 Authorization 头中包含您的 API Key：
Authorization: Bearer sk-your-api-key请求示例
curl -X POST https://nano-banana-pro.net/api/ai/nano-banana/generate \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{"prompt": "一只可爱的猫"}'const response = await fetch('https://nano-banana-pro.net/api/ai/nano-banana/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-your-api-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({ prompt: '一只可爱的猫' }),
});import requests
response = requests.post(
'https://nano-banana-pro.net/api/ai/nano-banana/generate',
headers={
'Authorization': 'Bearer sk-your-api-key',
'Content-Type': 'application/json',
},
json={'prompt': '一只可爱的猫'}
)API Key 限制
- 每个用户最多 5 个 API Keys
- Keys 不会自动过期
- 您可以随时在设置页面删除 Keys
安全最佳实践
永远不要暴露您的 API Key
不要在客户端代码、公开仓库或任何可能被他人访问的地方包含您的 API Key。
使用环境变量
将您的 API Key 存储在环境变量中，而不是硬编码：
# .env 文件
NB_PRO_API_KEY=sk-your-api-key// 使用方式
const apiKey = process.env.NB_PRO_API_KEY;定期轮换 Keys
如果您怀疑 Key 已被泄露，请立即删除它并创建新的。
为不同环境使用不同的 Keys
为开发、测试和生产环境创建单独的 API Keys。
认证错误
| 状态码 | 错误 | 描述 |
|---|---|---|
401 | Unauthorized | API Key 缺失或无效 |
402 | Payment Required | 积分不足或没有有效订阅 |
403 | Forbidden | API Key 没有执行此操作的权限 |
错误响应示例
{
"error": "Unauthorized"
}下一步
生成图片
了解如何使用图片生成 API 端点