❗限制条件
本页只说明接入前必须明确的约束，不展开完整接口契约。
鉴权方式
- 调用接口时在请求头中传入 获取Token
- 提交任务接口请求体类型为
- 提交任务接口响应类型为
地区与 Origin
国内调用建议显式携带：
Origin: https://www.docmee.cn并在请求体中传：
{
"address": "cn"
}服务端会根据请求来源判断国内或海外账号体系，判断优先级为：
Origin > Referer > X-Forwarded-Host > Host > body.address国内 API 调用建议
API 调试工具、后端脚本和服务端转发通常不会自动携带 。如果网关把 改成海外域名，服务端可能按海外账号体系校验 ，导致类似“缺少 companyId，无法扣减额度”的错误。
国内接口调用请同时保持 和 。
图片 URL 约束
- 中每个元素代表一页 PPT。
- 必须是服务端可直接访问的图片 URL。
- 图片 URL 响应内容应为图片，不要返回 HTML、JSON、鉴权页或跳转页。
- 不建议使用内网地址、依赖浏览器登录态的地址或即将过期的签名地址。
- 数组顺序就是最终 PPT 的页顺序。
remove_mode 约束
是每页必填的处理模式：
| 值 | 说明 |
|---|---|
text | 仅处理文字，输出可编辑文字层 |
elements | 仅处理元素，跳过文字去除 |
all | 同时处理文字和元素，输出更完整的可编辑 PPT |
首次接入如果没有特殊需求，建议使用 。
SSE 断线约束
- SSE 断开后，后端任务仍会继续执行。
- 收到 事件后必须保存 。
- 如果客户端没有收到 或 ，应通过状态查询接口补查结果。
- 状态查询接口不会重新生成 PPT，也不会再次扣积分。
部分成功约束
- 只要至少 1 页成功，任务会返回 。
- 生成的 PPT 只包含成功页。
- 失败页会在 中返回。
- 只有成功转换的图片页会计费，失败图片不计费；计费规则见 能力计费。
Last updated on