API Key 与模型

API Key 无效

出现 401 时检查：

1. 密钥是否完整复制。
2. 首尾是否包含空格或换行。
3. 密钥是否在控制台中启用。
4. 请求头是否使用正确的认证格式。

OpenAI 兼容请求头：

Authorization: Bearer YOUR_API_KEY

模型价格未配置

如果出现 model_price_error，表示平台尚未为该模型配置销售价格。普通用户无法通过修改客户端解决。

处理方式：

• 暂时选择模型广场中已经展示价格的其他模型。
• 将完整模型名称和错误时间反馈给 Hoofox。

Model not found

可能原因：

• 模型名称拼写错误。
• API Key 所属分组不支持该模型。
• 密钥启用了模型白名单，但没有包含目标模型。
• 当前渠道暂时没有开放该模型。

查询实际可用模型

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

返回列表中的 id 才是当前 API Key 可以直接使用的模型标识。