ClaudeHub

Appearance

常见问题 - 技术问题 ​

连接问题 ​

报错 "无法连接到服务器" ​

请检查：

  1. 网络是否正常
  2. API 地址是否正确：https://api.qinzhiai.com
  3. 是否被防火墙阻止

报错 401 Unauthorized ​

API Key 无效或格式错误：

  1. 检查 API Key 是否正确复制（无多余空格）
  2. 确认令牌未被禁用
  3. 重新创建一个新令牌

报错 403 Forbidden ​

请求被拒绝，可能原因：

  1. IP 触发了安全防护
  2. 请求内容触发了过滤规则

请联系客服排查。

报错 429 Too Many Requests ​

请求频率过高：

  1. 降低请求频率
  2. 添加请求间隔
  3. 使用队列控制并发

请求超时 ​

  1. 减少输入内容长度
  2. 设置更长的超时时间
  3. 尝试其他模型

模型问题 ​

支持哪些模型？ ​

支持 700+ 模型，包括：

  • Claude 系列（Opus 4.5、Sonnet 4、Haiku）
  • OpenAI 系列（GPT-5、o3、GPT-4.1、GPT-4o）
  • Gemini 系列（Gemini 2.5、Gemini 3）
  • DeepSeek 系列（V3.2、R1）
  • Midjourney
  • 等等

完整列表见 模型页面

模型返回空消息 ​

  1. 检查模型名称是否正确
  2. 确认输入格式正确
  3. 尝试其他模型

返回内容被截断 ​

设置更大的 max_tokens 参数：

python
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[...],
    max_tokens=4096  # 增加输出长度
)

Claude Code 可以用其他模型吗？ ​

Claude Code 需要 Agent 能力，仅支持：

  • claude- 开头的模型
  • cc- 开头的模型
  • cld- 开头的模型
  • 部分支持 Agent 的第三方模型

格式问题 ​

需要在 API 地址后加 /v1 吗？ ​

取决于您使用的工具：

  • OpenAI SDK：需要 /v1，如 https://api.qinzhiai.com/v1
  • Anthropic SDK：不需要，使用 https://api.qinzhiai.com
  • 其他工具：参考对应教程

OpenAI 格式和 Claude 原生格式的区别？ ​

OpenAI 格式（兼容性好）：

json
{
  "model": "claude-sonnet-4-20250514",
  "messages": [{"role": "user", "content": "Hello"}]
}

Claude 原生格式（功能完整）：

json
{
  "model": "claude-sonnet-4-20250514",
  "max_tokens": 1024,
  "messages": [{"role": "user", "content": "Hello"}]
}

大部分场景使用 OpenAI 格式即可。

流式响应格式异常 ​

确保正确处理 SSE（Server-Sent Events）格式：

  1. 按行读取响应
  2. 去除 data: 前缀
  3. 处理 [DONE] 结束标记

其他问题 ​

深夜使用不稳定 ​

深夜 1-5 点是服务器维护时段，可能有短暂的服务中断。

如何提高并发？ ​

  1. 使用专用高并发线路
  2. 合理设置请求队列
  3. 做好重试机制
  4. 日请求量超过百万可联系客服申请企业专线

数据安全如何保障？ ​

  1. 仅记录必要的请求日志
  2. 不存储用户请求内容
  3. 数据传输全程加密