> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmax.com/llms.txt > Use this file to discover all available pages before exploring further. # Doc2X V3 PDF 转换 > - Doc2X V3 PDF 文档转换模型，将 PDF 转换为 Markdown / LaTeX / DOCX 格式 - 支持公式识别与跨页表格合并 - 结果为 ZIP 压缩包（含转换文档与图片资源），通过 `results[0].url` 下载 - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 结果格式为 `{url}`，URL 指向一个可下载的 ZIP 压缩包，内含转换后的文档文件（md / tex / docx）及图片资源，详见 [任务查询特殊格式说明](/pages/zh/api-manual/task-management/get-task-detail#特殊格式) - ZIP 链接有效期为24小时，请尽快下载保存 ## OpenAPI ````yaml openapi/zh/doc2x-v3.json POST /v1/run/generations openapi: 3.1.0 info: title: Doc2X V3 PDF 转换 version: '1.0' servers: - url: https://api.aihubmax.com security: - BearerAuth: [] paths: /v1/run/generations: post: tags: - Document > PDF 转换 summary: Doc2X V3 PDF 转换 description: > - Doc2X V3 PDF 文档转换模型，将 PDF 转换为 Markdown / LaTeX / DOCX 格式 - 支持公式识别与跨页表格合并 - 结果为 ZIP 压缩包（含转换文档与图片资源），通过 `results[0].url` 下载 - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 结果格式为 `{url}`，URL 指向一个可下载的 ZIP 压缩包，内含转换后的文档文件（md / tex / docx）及图片资源，详见 [任务查询特殊格式说明](/pages/zh/api-manual/task-management/get-task-detail#特殊格式) - ZIP 链接有效期为24小时，请尽快下载保存 operationId: doc2x-v3 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Doc2xRequest' examples: pdf_to_markdown_default_settings: summary: PDF to Markdown (default settings) value: model: doc2x-v3 pdf_url: https://example.com/document.pdf page_count: 10 convert_mode: md formula_mode: normal filename: output merge_cross_page_forms: false responses: '200': $ref: '#/components/responses/TaskCreated' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: Doc2xRequest: type: object required: - model - pdf_url - page_count properties: model: examples: - doc2x-v3 type: string default: doc2x-v3 description: '`doc2x-v3`：PDF → md / tex / docx 转换，结果为可下载的 ZIP 压缩包' pdf_url: description: PDF 文件下载地址 type: string example: https://example.com/document.pdf page_count: description: PDF 页数，用于预扣费与执行时校验 minimum: 1 type: integer example: 10 convert_mode: default: md description: 输出格式 enum: - md - tex - docx type: string example: md formula_mode: default: normal description: 公式处理模式 enum: - normal - dollar type: string example: normal filename: anyOf: - maxLength: 200 type: string - type: 'null' default: null description: 输出文件名（不含扩展名，超 50 字执行时截断） example: output merge_cross_page_forms: default: false description: 是否合并跨页表格 type: boolean example: false TaskResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1757165031 id: type: string description: 任务ID example: task-unified-1757165031-uyujaw3d model: type: string description: 实际使用的模型名称 object: type: string description: 任务的具体类型 enum: - document.generation.task progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态 enum: - pending - processing - completed - failed example: pending task_info: type: object description: 异步任务信息 properties: can_cancel: type: boolean description: 任务是否可以取消 example: true estimated_time: type: integer description: 预计完成时间（秒） example: 45 type: type: string description: 任务的输出类型 enum: - document example: document ErrorResponse400: type: object properties: error: type: object properties: message: type: string example: 请求格式错误 type: type: string example: invalid_request_error ErrorResponse401: type: object properties: error: type: object properties: message: type: string example: API密钥无效 type: type: string example: authentication_error ErrorResponse402: type: object properties: error: type: object properties: message: type: string example: 账户余额不足 type: type: string example: insufficient_quota ErrorResponse422: type: object properties: error: type: object properties: message: type: string example: 参数校验失败 type: type: string example: validation_error ErrorResponse429: type: object properties: error: type: object properties: message: type: string example: 请求频率超限 type: type: string example: rate_limit_error ErrorResponse500: type: object properties: error: type: object properties: message: type: string example: 服务器内部错误 type: type: string example: server_error ErrorResponse503: type: object properties: error: type: object properties: message: type: string example: 服务暂不可用，请稍后重试 type: type: string example: service_unavailable responses: TaskCreated: description: 任务创建成功 content: application/json: schema: $ref: '#/components/schemas/TaskResponse' BadRequest: description: 请求格式错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse400' Unauthorized: description: 未授权 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse401' PaymentRequired: description: 余额不足 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse402' UnprocessableEntity: description: 参数校验失败 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse422' TooManyRequests: description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse429' InternalServerError: description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse500' ServiceUnavailable: description: 服务暂不可用 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse503' securitySchemes: BearerAuth: type: http scheme: bearer description: | ## 所有接口均需要使用Bearer Token进行认证 ## 使用时在请求头中添加： `Authorization: Bearer YOUR_API_KEY` ````