最佳实践
请求前检查图片 URL
- 提交前确认每个 都能被服务端直接访问。
- 避免使用内网地址、依赖登录态的地址、即将过期的签名地址或非图片内容地址。
- 对大批量图片先做抽样访问检查，减少单页失败。
固定地区识别信息
- 国内调用建议始终携带 。
- 请求体中同时传 。
- 如果通过服务端网关转发，注意不要让 误导账号体系识别；详细规则见 ❗限制条件。
正确处理 SSE
- 使用支持流式读取的客户端，不要等整个响应结束后再解析。
- 只解析 开头的 JSON 内容，以 开头的 keepalive 行可以忽略。
- 收到 后立即保存 。
- 收到 或 后可以关闭连接。
断线后补查状态
- SSE 断线后不要立刻重复提交同一批图片，避免产生重复任务。
- 使用已保存的 调用状态查询接口。
- 查询接口不会重新生成 PPT，也不会扣积分。
记录部分成功结果
- 即使收到 ，也要检查 和 。
- 业务日志中建议记录失败页下标、图片 URL 和失败原因。
- 对用户展示时说明“结果 PPT 只包含成功页”，避免误以为原始图片全部进入了结果文件。
做好计费核对
- 按 核对本次任务计费页数。
- 图片转 PPT 每张成功转换的图片消耗 积分。
- 失败图片不计费；全部失败时不会生成 PPT。
Last updated on