使用 REST API

EasyDoc REST API 提供高效的文档解析功能，助力开发者将非结构化文档转化为适合LLM应用的结构化数据。使用 API 需完成以下两步：

1. 发起解析任务：通过 POST /v1/easydoc/parse 上传文档，创建解析任务。
2. 查询任务状态与结果：通过 GET /v1/easydoc/parse/{task_id} 获取任务状态及解析结果。

以下为两个接口的详细说明，包含请求格式、响应结构、示例代码及错误处理，协助开发者快速集成。

1. 发起解析任务

1.1 请求说明

• 方法：POST
• 路径：https://api.easylink-ai.com/v1/easydoc/parse
• 头部：
  • api-key: 您的 API 密钥，用于身份验证。
• 请求体（multipart/form-data）：
  • files: 待解析文档（支持多文件上传），支持格式：
    • .pdf, .txt, .doc, .docx, .ppt, .pptx
    • 最大文件大小：100 MB
  • mode: 解析模式，可选值：
    • lite: 快速解析，提取布局块和文本。
    • pro: 深度解析，合并跨页/跨栏块，构建章节层次。
    • premium: 高级解析，包含图表和表格深度理解。

1.2 示例代码

import requests

url = "https://api.easylink-ai.com/v1/easydoc/parse"
headers = {
  "api-key": "<your-api-key>"
}

files = [
  ("files", open("<your-parse-file-path1>", "rb")),
  ("files", open("<your-parse-file-path2>", "rb"))  # 可以传单个，或多个文件
]

data = {
  "mode": "lite"
}

response = requests.post(url, headers=headers, files=files, data=data)

print(response.status_code)
print(response.json())

1.3 响应说明

• 成功响应：

  {
    "data": {
      "task_id": "b_parse_81d006e2-9295-4752-9033-9a37f24bc11d1748171169254"
    },
    "success": true
  }

2. 查询任务状态与结果

2.1 请求说明

• 方法：GET
• 路径：https://api.easylink-ai.com/v1/easydoc/parse/{task_id}
• 头部：
  • api-key: 您的 API 密钥。
• 路径参数：
  • task_id: 发起任务时返回的任务 ID。

2.2 示例代码

import requests

task_id = "<your-task-id>"
url = f"https://api.easylink-ai.com/v1/easydoc/parse/{task_id}"
headers = {
  "api-key": "<your-api-key>"
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.json())

2.3 响应说明

• 执行中：

  {
    "data": {
      "status": "PROCESSING",
      "task_id": "b_parse_26a9136f-2460-40bd-9923-ddb880131f311748176033858"
    },
    "success": true
  }

• 执行完成：

数据（data）

任务结果（results）

节点信息（nodes）

区域组成（composing_blocks）

成功状态（success）