---
title: "文档导出接口说明"
subtitle: "版本 1.0 · 面向客户端开发者"
---

# 接口用途

提交已经确认的文稿，创建一个可查询状态的导出任务。只有状态变为 `completed` 后，客户端才显示下载入口。

# 请求示例

```json
{
  "format": "docx",
  "title": "项目说明",
  "include_page_numbers": true
}
```

# 字段定义

| 字段 | 类型 | 说明 |
| :--- | :--- | :--- |
| format | string | 输出文件格式 |
| title | string | 文件内显示的标题 |
| include_page_numbers | boolean | 是否插入页码 |

# 错误处理

- 文件不存在：提示重新选择源文件。
- 网络中断：保留任务编号，查询原任务状态。
- 格式不支持：说明支持的格式，避免重复提交。
