身份验证

使用 Bearer API 密钥对 Bitdeer AI API 请求进行身份验证。

所有 API 请求都必须在 Authorization 请求头中包含一个 Bearer Token。

GET /v1/models HTTP/1.1
Host: api-inference.bitdeer.ai
Authorization: Bearer $BITDEER_API_KEY

获取你的 API 密钥

  1. 登录 Bitdeer AI 控制台。
  2. 进入 模型 → API 密钥 页面(直接链接)。
  3. 点击 生成 API 密钥 并复制密钥——密钥的密文仅显示一次。

使用示例

curl https://api-inference.bitdeer.ai/v1/models \
  -H "Authorization: Bearer $BITDEER_API_KEY"

Anthropic 风格的 x-api-key 请求头

Anthropic SDK 及相关工具也可以通过 x-api-key 请求头发送密钥:

curl https://api-inference.bitdeer.ai/v1/messages \
  -H "x-api-key: $BITDEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "Qwen/Qwen3.8-27B", "max_tokens": 256, "messages": [{"role": "user", "content": "Hello!"}]}'
  • x-api-key 仅适用于 20 位的 API 密钥(不以 ak- 开头的密钥),且仅在未发送 Authorization 请求头时生效。
  • 以 ak- 开头的密钥必须使用 Authorization: Bearer。
  • Authorization: Bearer 适用于所有密钥格式和所有端点。

密钥管理最佳实践

  • 切勿将密钥提交到代码仓库或打包到前端代码中。
  • 通过环境变量或密钥管理工具加载密钥。
  • 通过创建新密钥、部署后再停用旧密钥的方式定期轮换密钥。

未授权响应

API 密钥缺失、格式错误、不存在或已过期时返回 401 Unauthorized(code 为 invalid_api_key)—— 请参见 错误 了解响应体结构。形如 JWT 的 Bearer Token(以 eyJ 开头且包含两个点)不是 API 密钥,会被以 501 拒绝。

最后更新于

本页目录