创建任务时设置 input_format;调用 POST /transforms/{uuid}/launch 时设置本页参数。启动请求被接受后,参数不能修改。
支持的格式组合
| 输入 | 输出 | 翻译 | 排版模式 |
|---|---|---|---|
| Markdown ZIP 或 EPUB | 可选 | 不翻译使用 source;翻译可用 replace、bilingual、bilingual-inline | |
| 必须 | 仅 replace | ||
| EPUB | EPUB | 必须 | replace、bilingual、bilingual-inline |
此 API 不支持 EPUB 转 PDF/Markdown,也不支持不翻译的 PDF 转 PDF。
保留原文语言
PDF 转 EPUB 时,省略 target_language:
{"output_format":"epub"}输出 Markdown ZIP 则使用 "output_format":"markdown"。不翻译时,rendering_mode 默认是 source,不能提供翻译提示或双语模式。
翻译文档
将 PDF 或 EPUB 翻译为英文 EPUB:
{ "output_format": "epub", "target_language": "en", "rendering_mode": "bilingual", "translation_prompt": "Keep product names unchanged."}replace 仅输出译文,是翻译时的默认值。bilingual 按文本块追加译文;bilingual-inline 在同一文本流内追加译文。这两种模式均不生成左右双栏 PDF。
输出翻译后的 PDF:
{"output_format":"pdf","target_language":"en","rendering_mode":"replace"}可通过 translation_prompt 指定术语或人名的译法。该字段可省略;填写时不能全为空白,服务会去除首尾空白。它不支持指定模型。
请求中包含未知字段,或参数不适用于当前转换时,返回 400 INVALID_REQUEST。
PDF 脚注
footnotes | 行为 |
|---|---|
disabled | 禁用脚注提取,默认值 |
basic | 基础脚注提取 |
refined | 精细脚注处理 |
{"output_format":"epub","footnotes":"refined"}EPUB 输入不能传入 footnotes,包括 "footnotes":"disabled"。该选项只控制 PDF 脚注,API 暂不提供页眉、页脚的独立开关。
翻译目标语言
target_language 仅接受以下区分大小写的代码:
| 代码 | 语言 | 代码 | 语言 |
|---|---|---|---|
zh-CN | 中文 | en | 英语 |
de | 德语 | es | 西班牙语 |
fr | 法语 | it | 意大利语 |
ja | 日语 | ko | 韩语 |
pt | 葡萄牙语 | ru | 俄语 |
ar | 阿拉伯语 | hi | 印地语 |
nl | 荷兰语 | pl | 波兰语 |
tr | 土耳其语 | vi | 越南语 |
th | 泰语 | id | 印度尼西亚语 |
sv | 瑞典语 | da | 丹麦语 |
no | 挪威语 | fi | 芬兰语 |
网站界面的语言标签不一定等于 API 语言代码。zh、zh-Hant、it-IT、pt-BR、语言全名以及带首尾空白的值都会被拒绝。