常见问题

连接问题

如何确认中转站连接正常？

使用 cURL 快速测试：

curl https://huobaoapi.com/v1/models \
  -H "Authorization: Bearer hb-xxxxxxxxxxxx"

如果返回模型列表 JSON，说明连接正常。

遇到 401 Unauthorized 错误

可能原因

• API Key 填写不正确（注意前后不能有空格）
• API Key 已过期或被禁用
• API Key 没有对应模型的调用权限

解决方法： 登录控制台检查 API Key 状态，必要时重新生成。

遇到 429 Too Many Requests 错误

说明

请求频率超出了速率限制。

解决方法：

• 稍后重试
• 在控制台查看当前速率限制配额
• 如需更高配额，请联系管理员

遇到 502 / 503 错误

可能原因： 上游 API 服务暂时不可用。

解决方法： 等待几分钟后重试，如果持续出现请联系管理员。

配置问题

Base URL 需不需要加 /v1？

取决于使用的工具：

工具	Base URL 格式
Cursor	https://huobaoapi.com/v1 ✅ 需要 /v1
Claude Code	https://huobaoapi.com ✅ 不需要 /v1
Cline	https://huobaoapi.com/v1 ✅ 需要 /v1
Continue	https://huobaoapi.com/v1 ✅ 需要 /v1
Aider	https://huobaoapi.com/v1 ✅ 需要 /v1
ChatBox	https://huobaoapi.com ✅ 不需要 /v1
Cherry Studio	https://huobaoapi.com ✅ 不需要 /v1

经验法则

大部分工具需要 /v1 后缀。Anthropic 系工具和部分桌面客户端会自动拼接，所以不需要。

环境变量和应用内设置冲突了怎么办？

应用内设置通常优先级更高。建议只使用一种方式配置，避免混淆。如果不确定，先清除环境变量，只用应用内设置。

支持哪些模型？

请访问控制台或调用 /v1/models 接口查看当前支持的完整模型列表。常用模型包括：

模型	说明
gpt-4o	OpenAI GPT-4o，多模态
gpt-4.1	OpenAI GPT-4.1，最新版
gpt-4o-mini	GPT-4o 轻量版，适合补全
claude-sonnet-4-20250514	Claude 4 Sonnet，编程能力强
claude-opus-4-20250514	Claude 4 Opus，最强推理
gemini-2.5-pro	Google Gemini 2.5 Pro