U9 AI · DOCUMENTATION

常见错误与排查工单

排查认证、模型路由、流式输出与资源缺失，并提交有效工单。

按这个顺序排查#

现象	优先检查
401 / 403	是否为本站密钥、是否启用或过期、密钥限制与认证头是否正确
模型不可用	模型 ID 是否准确、账户权限、路由是否启用、端点协议是否匹配
余额不足	可用与冻结余额、所选生成规格及预估费用
400 / 422	模型必填字段、支持的时长比例、参考图格式
429	平台或上游限流，遵循 Retry-After，避免集中重试
5xx / 超时	保存请求号和时间，重新提交前先查已有任务
编程助手能聊天却不能用工具	Responses / Messages 支持、流式事件、工具调用往返和客户端版本
显示完成却没有下载	任务详情、输出 URL 和资源有效期，反馈原任务号

打开私人工单，提供模型 ID、生成模式、请求号或任务号、带时区的准确时间、工具版本、请求路径、HTTP 状态码及脱敏错误文本。说明预期结果和实际现象，必要时附脱敏截图。不要附完整 Authorization 头、API 密钥、Cookie、私钥或未经脱敏的配置文件。

网络超时可能发生在上游已经接受任务之后。先查询已有任务详情，不要连续点击生成，除非该模型接口明确保证幂等性，否则不要自动重试创建请求。结合请求记录、钱包流水和消费分析确认最终结果与费用。