伯克利API 接入文档
通过统一 HTTPS 地址接入服务。请在控制台创建独立密钥,并在服务端安全保存。
快速开始
API 根地址:
https://bokeli.top
身份认证
所有受保护请求使用 Bearer Token。不要把密钥写入网页、公开仓库或客户端安装包。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
发送请求
POST
/v1/chat/completionscurl -X POST "https://bokeli.top/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model",
"messages": [
{"role": "user", "content": "你好"}
]
}'
错误处理
| 状态码 | 含义 | 处理方式 |
|---|---|---|
400 | 请求参数不正确 | 检查 JSON、路径和必填字段 |
401 | 认证失败 | 检查密钥是否有效 |
429 | 请求过快或额度不足 | 降低并发并检查余额 |
5xx | 服务暂时不可用 | 使用指数退避重试,并保留请求 ID |
用量与日志
当前账号的余额与用量可在控制台查看。管理员在“使用日志”中切换“全部/仅自己”可以区分全站口径与个人口径。
安全建议
- 为不同应用创建不同密钥,便于撤销与审计。
- 密钥只保存在服务端环境变量或密钥管理系统中。
- 客户端应设置连接和读取超时,并记录请求 ID。
- 怀疑泄露时立即撤销旧密钥并创建新密钥。