故障排查

拓元智算 API 通过统一入口提供多模型访问。公开接口只使用 api.tuoyuan.ai 与拓元智算 API Key；上游路由对调用方透明。

401 / 403

确认使用的是模型调用 API Key，而不是管理类密钥；检查是否有多余空格。

模型不存在

先请求 /v1/models，使用实时返回的 model ID。

Claude Code 无响应

确认使用 Anthropic-compatible Base URL https://api.tuoyuan.ai。

Codex / OpenCode 无响应

确认使用 https://api.tuoyuan.ai/v1，Codex 配置 wire_api = "responses"。

429 / 5xx

降低并发并指数退避重试；持续异常时保留时间、模型和 request ID 供排查。