认证与密钥

正确配置企业域名和请求头,管理密钥的权限与生命周期。

模型调用使用企业 API Key。到 企业 API Key 页面 创建并复制完整密钥,然后存入服务端环境变量或密钥管理服务。

Base URL

使用方式地址
OpenAI SDK / OpenAI 兼容客户端https://enterprise.beefapi.com/v1
Anthropic SDK / Claude Codehttps://enterprise.beefapi.com
直接 HTTP 调用企业域名加完整接口路径,如 /v1/messages

OpenAI SDK 会在 Base URL 后拼接 chat/completions;Anthropic SDK 自己添加 /v1/messages。重复 /v1/v1 或漏掉 /v1 都可能造成 404。

请求头

通用 Bearer 认证:

Authorization: Bearer sk-YOUR_ENTERPRISE_API_KEY
Content-Type: application/json

Anthropic Messages 也可使用:

x-api-key: sk-YOUR_ENTERPRISE_API_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

/v1/usage 与 /v1/usage/requests 使用 Bearer 请求头。浏览器登录 Cookie 不能替代服务端模型调用的 Key。

密钥与钱包是两道检查

企业 Key 只应在企业域名使用。切换到其他站点不能借用那里的余额。即使企业钱包还有余额,Key 自己的额度、有效期、模型限制或 IP 限制也可能阻止调用。

为开发环境和正式应用分别创建 Key,在控制台设置适当的额度、有效期和可调用模型。额度是 Key 的使用限制,不是额外的一份钱包资金。

更换或泄露后的处理

创建新 Key,更新服务端配置,用查询目录和一条必要的功能验证确认接入,再停用旧 Key。若已泄露,立即停用并查看异常调用。

只读用量接口允许仍存在的过期、耗尽或停用 Key 查询历史,但仍检查账号状态、站点和 IP 限制。因此停用后仍需保密;需要移除密钥访问时在控制台删除,先导出自己需要的历史记录。

账户管理接口与模型接口的凭据不同。不要把账户系统访问令牌填入 OpenAI SDK 的 api_key。本手册的模型与用量示例均使用企业 API Key。

本页内容