错误码说明
本页用于集中说明 图片转 PPT 能力常见 HTTP 错误、触发原因和处理建议。
错误码总览
| HTTP 状态码 | 常见原因 | 处理建议 |
|---|---|---|
400 | 缺少 companyId、debug_id 格式错误、图片 URL 内容不是图片 | 检查 token、Origin、address、图片 URL |
401 | 缺少 token | 补充 token Header |
403 | 额度或积分不足 | 充值或减少本次提交页数 |
404 | debug_id 不存在或任务尚未写入状态 | 确认 debug_id，稍后重试 |
409 | 任务尚未完成，暂不能导出 PPT | 等待任务完成后重试 |
422 | 请求参数错误，例如缺少 address 或 remove_mode 不合法 | 按参数表修正请求体 |
500 | 服务端配置或处理异常 | 稍后重试或联系技术支持 |
502 | 用户额度或积分服务返回异常 | 稍后重试或联系技术支持 |
400
- 含义：请求无法被正确处理
- 常见触发条件：
- 国内调用缺少稳定的 ，导致账号体系识别异常
- 格式错误
- 图片 URL 响应内容不是图片
- 建议处理：检查 、、 和图片 URL 后重新提交
401
- 含义：缺少调用凭证
- 常见触发条件：
- 请求头没有传
- 建议处理：补充有效的 Header
403
- 含义：额度或积分不足
- 常见触发条件：
- 当前账户可用积分不足以完成本次任务
- 建议处理：充值或减少本次提交图片数量后重新发起任务
404
- 含义：任务状态不存在
- 常见触发条件：
- 不存在
- 任务刚开始，状态尚未写入完成
- 建议处理：确认 是否来自 事件；如任务刚提交，可稍后重试查询
409
- 含义：任务尚未完成
- 常见触发条件：
- 任务仍在处理中，暂时无法导出 PPT
- 建议处理：继续等待 SSE 最终事件，或稍后再次查询状态
422
- 含义：请求参数错误
- 常见触发条件：
- 缺少
- 缺失或为空
- 不是 、、
- 建议处理：按 完整 API 文档 修正请求体
500
- 含义：服务端配置或处理异常
- 常见触发条件：
- 图片处理、导出或上传阶段出现服务内部异常
- 建议处理：记录 ，稍后重试；如持续出现，请联系平台支持
502
- 含义：用户额度或积分服务返回异常
- 常见触发条件：
- 额度服务临时不可用
- 建议处理：稍后重试；如持续出现，请联系平台支持
Last updated on