> ## Documentation Index > Fetch the complete documentation index at: https://adp-doc.laiye.com/llms.txt > Use this file to discover all available pages before exploring further. # 查询文档转换异步任务 > 根据 task_id 查询转换结果。当前响应没有独立的任务状态字段；任务仍在处理时可能返回 code=success 以及空的 img_detail_list/total_num。请使用退避轮询，并在取得页面结果或电子表格结构后再结束。 空结果不能可靠区分“处理中”和“无可视页面”，请为客户端设置总超时和最大轮询次数。 ## OpenAPI ````yaml api-reference/adp-api.yaml GET /open/agentic_doc_processor/{tenant_name}/v1/doc/convert/query/task/{task_id} openapi: 3.1.0 info: title: ADP API version: 1.0.0 description: >- Laiye ADP 官方 OpenAPI 接口规范，覆盖文档抽取、解析与转换，抽取应用管理、Webhook、人机协同、积分查询，以及工作流发现、运行、导出和文件管理。 license: name: MIT identifier: MIT servers: - url: https://adp.laiye.com description: ADP 生产环境 security: [] tags: - name: 文档抽取 description: 从上传的文档中抽取结构化字段。 - name: 文档解析 description: 识别上传文档中的文字、版面块和位置信息。 - name: 文档转换 description: 将 PDF、Office、OFD 和图片转换为页面图片或电子表格结构。 - name: 应用管理 description: 创建、修改、删除和查询抽取应用及配置。 - name: Webhook description: 查询事件目录并管理事件回调。 - name: 账户 description: 查询账户积分和使用情况。 - name: 工作流 description: 查询业务工作流模板、运行工作流应用并查询执行结果。 - name: 工作流文件 description: 上传和管理工作流应用使用的文件。 - name: 人机协同 description: 配置审核触发规则，查询协同任务并提交人工修正。 paths: /open/agentic_doc_processor/{tenant_name}/v1/doc/convert/query/task/{task_id}: get: tags: - 文档转换 summary: 查询文档转换异步任务 description: > 根据 task_id 查询转换结果。当前响应没有独立的任务状态字段；任务仍在处理时可能返回 code=success 以及空的 img_detail_list/total_num。请使用退避轮询，并在取得页面结果或电子表格结构后再结束。 空结果不能可靠区分“处理中”和“无可视页面”，请为客户端设置总超时和最大轮询次数。 operationId: queryDocumentConvertTask parameters: - $ref: '#/components/parameters/TenantName' - name: task_id in: path required: true description: 创建异步转换任务后返回的任务 ID。 schema: type: string minLength: 1 responses: '200': $ref: '#/components/responses/DocumentConvertResponse' '422': $ref: '#/components/responses/ValidationError' security: - ApiKeyAuth: [] components: parameters: TenantName: name: tenant_name in: path required: true description: 租户名称，默认 laiye。 schema: type: string default: laiye responses: DocumentConvertResponse: description: 文档转换结果。处理中或失败时可能返回空结果或 data=null。 content: application/json: schema: $ref: '#/components/schemas/DocumentConvertResponse' example: code: success message: '' tips: null data: task_id: task_abc123 img_detail_list: - page_num: 1 img_base64: '' img_url: https://example.com/temp/task_abc123/page-1.png width: 1240 height: 1754 preprocess: {} total_num: 1 metadata: {} file_type: pdf source_file_type: pdf spreadsheet_manifest_file_id: '' spreadsheet_manifest_url: '' view_type: '' page_count: 1 sheet_count: 0 logical_unit_count: 0 document_contents: [] document_details: [] warnings: [] billing: {} ValidationError: description: 参数校验错误。 content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' example: detail: - type: greater_than loc: - query - limit msg: Input should be greater than 0 input: 0 ctx: gt: 0 schemas: DocumentConvertResponse: allOf: - $ref: '#/components/schemas/SimpleResponse' - type: object properties: data: oneOf: - $ref: '#/components/schemas/DocumentConvertData' - type: 'null' HTTPValidationError: type: object description: FastAPI/Pydantic 请求参数校验错误。 properties: detail: type: array items: $ref: '#/components/schemas/ValidationErrorItem' required: - detail SimpleResponse: type: object properties: code: oneOf: - type: string - type: integer description: 业务码。成功通常为 success 或 200。 message: type: string description: 返回信息。 tips: type: - string - 'null' description: 详细信息，默认为空。 DocumentConvertData: type: object properties: task_id: type: string img_detail_list: type: array items: $ref: '#/components/schemas/DocumentConvertImage' total_num: type: integer minimum: 0 metadata: type: object additionalProperties: true file_type: type: string description: 转换结果类型，例如 pdf、image 或 spreadsheet。 source_file_type: type: string description: 检测到的源文件扩展类型。 spreadsheet_manifest_file_id: type: string spreadsheet_manifest_url: type: string description: Excel 原生预览 Manifest 临时下载地址。 view_type: type: string description: Excel 原生解析时为 spreadsheet。 page_count: type: integer minimum: 0 sheet_count: type: integer minimum: 0 logical_unit_count: type: integer minimum: 0 document_contents: type: array items: type: string document_details: type: array items: {} warnings: type: array items: type: object additionalProperties: true billing: type: object additionalProperties: true required: - task_id - img_detail_list - total_num - metadata - file_type - source_file_type - spreadsheet_manifest_file_id - spreadsheet_manifest_url - view_type - page_count - sheet_count - logical_unit_count - document_contents - document_details - warnings - billing ValidationErrorItem: type: object additionalProperties: true properties: type: type: string description: 校验错误类型。 loc: type: array description: 错误字段在请求中的位置。 items: oneOf: - type: string - type: integer msg: type: string description: 可读的错误说明。 input: description: 导致校验失败的输入值。 ctx: type: object additionalProperties: true description: 校验器提供的补充上下文。 url: type: string format: uri description: Pydantic 错误说明链接。 required: - type - loc - msg DocumentConvertImage: type: object properties: page_num: type: integer minimum: 0 img_base64: type: string description: result_mode=base64 时的页面图片内容，否则通常为空字符串。 img_url: type: string description: result_mode=url 时的临时页面地址，否则通常为空字符串。 width: type: integer minimum: 0 height: type: integer minimum: 0 preprocess: type: object additionalProperties: true required: - page_num - img_base64 - img_url - width - height - preprocess securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY description: 生产环境 API Key，可在 ADP 平台的「我的 API」中查看。请确保 API Key 有效且属于生产环境。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.