认证方式
了解如何使用 API 密钥进行身份认证
API 密钥认证
所有 API 请求需在 HTTP Header 中携带 Bearer Token 进行认证:
HTTP Header
Authorization: Bearer YOUR_API_KEY安全提示:请勿在前端代码或公开仓库中暴露 API 密钥。建议通过环境变量或后端服务代理调用。
获取密钥
- 登录 后,前往 密钥管理
- 点击「创建密钥」,输入名称后确认
- 创建成功后会显示完整密钥(仅此一次),请妥善保存
OpenAI SDK 兼容
API 完全兼容 OpenAI 格式,只需修改 base_url 即可使用官方 SDK:
Python
# Python
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="{YOUR_DOMAIN}/api/v1",
)JavaScript
// JavaScript
const client = new OpenAI({
apiKey: "YOUR_API_KEY",
baseURL: "{YOUR_DOMAIN}/api/v1",
});错误码
| HTTP 状态码 | 说明 |
|---|---|
| 401 | 未认证 |
| 403 | 权限不足 |
| 429 | 请求过多 |
| 500 | 服务器错误 |