常见问题与错误排查
先看具体错误，再检查地址、密钥和模型。
API 地址该填哪个？
控制台地址 https://app.apivy.xyz 用来管理账户，不能作为模型 API Base。
OpenAI 兼容客户端通常填 https://apivy.xyz/v1；自行补全版本路径的客户端与 Claude Code CLI 使用根地址 https://apivy.xyz。
401：认证失败
检查是否复制了完整密钥，而非掩码或网页登录密码。确认密钥启用、未过期、无多余空格。
403：请求被拒绝
查看具体错误。可能与账户状态、额度、IP 限制、访问规则有关，不应把所有 403 都认定为余额不足。
404：路径或模型不存在
检查地址是否重复 /v1、是否误填控制台域名、模型 ID 是否完整。区分接口 404 与响应里提示的模型错误。
429：限流或额度限制
按响应说明检查额度和限流，降低并发，必要时退避重试。无限立即重试通常会加重问题。
500 / 502 / 503：服务暂时无法处理
记录错误信息与时间，稍后重试。可能涉及网关资源、上游服务、渠道或网络；503 也可能是系统资源过载，不能仅判断为没有渠道。
网页或回复较慢
先区分是页面加载慢、请求首字慢，还是生成较长。尝试短文本，核对客户端网络、上下文、并发和模型耗时。首页打开快不代表所有模型响应时间相同。
余额还有，为什么不能调用？
同时检查密钥自身额度、到期时间、模型与 IP 限制，以及分组是否有可用渠道。
如何反馈问题？
提供脱敏的错误信息、请求时间、模型 ID、客户端版本和请求标识。不要提供完整密钥、密码或未脱敏的业务数据。