创建异步文档解析任务

开发指南 API参考

模型价格模型发布

创建文档解析任务，支持多种文件格式，支持输出Markdown和JSON。

POST/v1/files/parser/tasks

授权

Authorizationstringheader必填

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在项目管理>API Key 中查看。

请求头

Content-Typeenum<string>默认值:application/json必填

请求体的媒体类型，请设置为application/json以确保请求数据格式正确。

可用选项：application/json

请求体application/json

file_id string 必填

待处理文档的 file_id，通过文件上传接口获得。

上传文件格式需为：pdf、jpg、png
单个文件大小不超过 20MB

model enum<string> 必填

模型编码。可用选项：u1-ocr-parser。

start_page_id integer

开始页码，传入 PDF 时有效，默认从第一页开始。

end_page_id integer

结束页码，传入 PDF 时有效，默认处理到最后一页。

响应体结构

task_idstring

当前任务的 ID

base_respobject

本次请求的状态码及其详情

base_resp.status_codeint64

状态码（0=正常；100001=参数错误；100101=鉴权失败；100501=触发 RPM 限流；100999=系统内部错误）

base_resp.status_msgstring

状态详情

Start OCR

curl --request POST \
--url https://maas-api.hivoice.cn/v1/files/parser/tasks \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{
  "file_id": "file_id",
  "model": "u1-ocr-parser",
  "start_page_id": 1,
  "end_page_id": 3
}'

200

{
  "task_id": "task_1234567890abcdef",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}