故障排查

先用最小文本请求确认密钥、地址、模型和分组，再逐项加入复杂功能。记录问题发生时间和脱敏后的错误内容。

按错误定位

现象	优先检查	处理方法
401 / 无效密钥	密钥完整性、是否过期或停用、认证头	重新复制有效密钥，确认未混用账户密码或其他凭证
403 / 无权限	模型限制、分组、IP 限制	检查密钥配置与账户可用权限
404 / 路径不存在	Base URL 与实际请求路径	排除 /v1/v1，核对接口协议
model_not_found	模型 ID、分组和模型限制	复制完整模型 ID，查询当前密钥的模型列表
额度不足	密钥限额、钱包余额、套餐状态	到钱包与密钥页面分别核对
429 / 限流	请求频率、并发和渠道容量	降低并发，采用带退避的有限重试
502 / 503	上游渠道、服务状态或网关连接	稍后重试；持续失败时提供请求 ID
504 / 超时	网络、客户端超时、长任务	缩短测试请求，检查代理与超时设置

状态码需要结合响应正文判断，不同渠道可能返回不同错误信息。

没有任何调用日志

确认客户端确实访问 api.ontoway.ai。检查旧环境变量、本地代理和供应商切换是否生效。认证之前失败的请求也可能没有消费日志，不能仅凭没有日志判断网络未到达服务。

流式输出卡住

检查客户端是否支持 SSE、代理是否缓冲输出。先用非流式请求确认配置，再使用 curl -N 测试。不要将连接中断后自动重发的生成任务当作原请求的续传。

支付成功但未到账

刷新钱包并查看订单记录，保留订单号、金额与付款时间。联系支持核对，避免在订单状态不明时连续支付。

仍无法解决时，按联系支持整理信息。