[AI62-1] PDF 翻译-提交翻译任务

概述

通过 pdf 上传 PDF 文件，或通过 pdf_url 提供 PDF 下载链接（支持签名链接），两者必须且只能提供一个。output_format=pdf 输出保留版面的译文 PDF（默认），output_format=markdown 输出 Markdown 文本文件（.md）。任务接受后返回 HTTP 202。通过 status_url 查询状态；state 为 succeeded 后，访问 download_file 指向的结果接口获取所选格式的译文。 输入示例（文件上传，multipart/form-data）： ```bash curl -X POST 'http://s-patsnaprd-pdf-translation-api.patsnaprd/translate' \ -H 'accept: application/json' \ -F 'pdf=@/path/to/sample.pdf;type=application/pdf' \ -F 'source_lang=zh' \ -F 'target_lang=en' \ -F 'pages=1' \ -F 'model_id=9' \ -F 'output_format=pdf' ``` 输入示例（PDF 链接，multipart/form-data）： ```bash curl -X POST 'http://s-patsnaprd-pdf-translation-api.patsnaprd/translate' \ -H 'accept: application/json' \ -F 'pdf_url=https://storage.example.com/sample.pdf?signature=EXAMPLE' \ -F 'source_lang=zh' \ -F 'target_lang=en' \ -F 'pages=1' \ -F 'model_id=9' \ -F 'output_format=pdf' ``` 如需 Markdown 输出，将 output_format 改为 markdown；翻译全部页面时省略 pages。使用 pdf_url 时不传 pdf 字段。curl 使用 -F 自动生成带 boundary 的 multipart/form-data 请求头，无需手动设置 Content-Type。 成功响应示例（HTTP 202）： ```json { "task_id": "0123456789abcdef0123456789abcdef", "taskId": "0123456789abcdef0123456789abcdef", "job_id": "0123456789abcdef0123456789abcdef", "state": "pending", "source_lang": "zh", "target_lang": "en", "lang": "zh2en", "model_id": "9", "output_format": "pdf", "total_pages": 2, "selected_pages": [ 1 ], "selected_page_count": 1, "skipped_pages": [ 2 ], "skipped_page_count": 1, "status_url": "http://s-patsnaprd-pdf-translation-api.patsnaprd/tasks/0123456789abcdef0123456789abcdef", "download_file": "http://s-patsnaprd-pdf-translation-api.patsnaprd/tasks/0123456789abcdef0123456789abcdef/result", "message": "任务已提交。请轮询 status_url，成功后访问 download_file 获取结果：PDF。" } ``` 请求参数清单（multipart/form-data）： | 参数 | 类型 | 必填 | 示例 | | --- | --- | --- | --- | | pdf | file / string | 否；与 pdf_url 二选一 | sample.pdf | | pdf_url | string | 否；与 pdf 二选一 | https://storage.example.com/sample.pdf?signature=EXAMPLE | | source_lang | string | 否；建议显式传入 | zh | | target_lang | string | 否；建议显式传入 | en | | pages | string | 否；省略翻译全部页 | 1 | | model_id | string | 否；服务默认 9 | 9 | | output_format | string | 否；服务默认 pdf | pdf |

接口地址

post https://connect.zhihuiya.com/pdf-translation/translate

/openapi.json#/paths/~1pdf-translation~1translate/post

鉴权

所有智慧芽开放平台 REST API 均需在 Authorization 请求头中携带有效的 API Key（Bearer Token）。