鉴权方式

模型接口使用 Hoofox API Key 进行认证。API Key 通常以 sk- 开头。

Bearer Token

OpenAI 兼容接口建议使用以下请求头：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

示例：

curl https://www.hoofox.com/v1/models \
  -H "Authorization: Bearer $HOOFOX_API_KEY"

Anthropic 格式

调用 Anthropic Messages 接口时使用：

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

安全建议

不要将 API Key 写入公开代码

文档中的 YOUR_API_KEY 和环境变量只是占位符。真实密钥应保存在本机环境变量、密钥管理服务或客户端的安全配置中。

macOS 与 Linux

export HOOFOX_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:HOOFOX_API_KEY="YOUR_API_KEY"

认证失败

收到 401 Unauthorized 时依次检查：

1. 密钥是否完整，首尾是否包含空格。
2. 密钥在控制台中是否仍为启用状态。
3. 请求头是否包含正确的 Bearer 前缀。
4. 是否误把登录密码或系统访问令牌当成 API Key。