排查 ApiClo API 连接错误

开始之前

• 记录客户端版本、模型、接口地址与大致请求时间。
• 截图、公开日志和支持消息中不要包含密钥。

操作步骤

1. 检查地址与密钥

   OpenAI 兼容 Base URL 为 https://apiclo.com/v1；Claude Code 的 ANTHROPIC_BASE_URL 为 https://apiclo.com。用密钥请求 GET /v1/models，可将认证检查与生成分开。

2. 检查失败请求

   对照错误正文与 ApiClo Logs，核对模型表中的准确 ID。模型列表请求成功不代表生成或工具调用一定兼容。

3. 按错误原因重试

   先修正密钥或地址错误。遇到 429 时遵循 Retry-After（如有），并逐步增加等待时间。如果生成开始后超时，重新发送前先检查状态。

示例

curl https://apiclo.com/v1/models \
  -H "Authorization: Bearer YOUR_APICLO_KEY"

检查结果

修正后发送一次简短生成，核对模型、回复与用量记录。仍失败时，向支持提供已去除敏感信息的错误正文和请求 ID。

常见问题

• 401：检查密钥有效性、空格及接口要求的认证头。
• 403/404：检查响应正文、账户权限、准确模型 ID 和重复的 /v1。
• 429：频繁重试可能延长拥堵；退避时保持相同密钥和模型。
• 意外扣费或超时：重发可能已完成的生成前，先检查 Logs。

兼容性与计费

HTTP 状态无法独立解释所有上游或客户端问题。模型列表响应只验证该次请求。不要向支持发送完整 API 密钥。