# 常见错误与排查工单

## 按这个顺序排查

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

## 工单怎样提供信息最有效？

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

## 避免重复扣费

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