认证与密钥
正确配置企业域名和请求头,管理密钥的权限与生命周期。
模型调用使用企业 API Key。到 企业 API Key 页面 创建并复制完整密钥,然后存入服务端环境变量或密钥管理服务。
Base URL
| 使用方式 | 地址 |
|---|---|
| OpenAI SDK / OpenAI 兼容客户端 | https://enterprise.beefapi.com/v1 |
| Anthropic SDK / Claude Code | https://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/jsonAnthropic 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。