认证方式

了解如何使用 API 密钥进行身份认证

API 密钥认证

所有 API 请求需在 HTTP Header 中携带 Bearer Token 进行认证:

HTTP Header
Authorization: Bearer YOUR_API_KEY

安全提示:请勿在前端代码或公开仓库中暴露 API 密钥。建议通过环境变量或后端服务代理调用。

获取密钥

  1. 登录 后,前往 密钥管理
  2. 点击「创建密钥」,输入名称后确认
  3. 创建成功后会显示完整密钥(仅此一次),请妥善保存

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服务器错误

推荐阅读

AI Platform