错误处理与常见问题

发生错误时，同时检查 HTTP 状态、响应中的错误信息与请求 ID。请在日志和工单中遮盖令牌、签名、私有媒体地址和个人数据。

状态	优先检查
400	JSON 格式、必填字段、枚举值、媒体地址和任务 ID 是否正确
401	是否使用有效的 Max Router 令牌及正确的鉴权请求头
403	令牌的模型范围、分组与账号权限是否允许该操作
404	路径、任务 ID 和任务归属是否正确
429	请求频率、并发限制或额度；遵守响应提示并退避重试
5xx	暂时性服务错误；保留请求 ID，稍后重试或联系管理员

实际响应还可能包含模型或渠道相关的错误信息。提交生成任务后如果客户端超时，先核对是否已生成任务，避免盲目重复提交并产生额外费用。

常见问题

模型找不到或无可用渠道：先调用 GET /v1/models，检查模型名称、分组和令牌权限。

回调没有收到：检查公网 HTTPS 地址、接收端返回状态和网关运行状态，同时使用任务查询接口确认结果。

图片或视频无法读取：检查链接是否对服务端可访问、未过期且符合模型要求。

网页调试无法连接 API：检查网络连接、基础地址 https://maxrouterai.com 和当前服务状态。