跳到主要内容
本页内容

API

转换与翻译参数

支持的文件格式、翻译模式和脚注选项。

创建任务时设置 input_format;调用 POST /transforms/{uuid}/launch 时设置本页参数。启动请求被接受后,参数不能修改。

支持的格式组合

输入输出翻译排版模式
PDFMarkdown ZIP 或 EPUB可选不翻译使用 source;翻译可用 replace、bilingual、bilingual-inline
PDFPDF必须仅 replace
EPUBEPUB必须replace、bilingual、bilingual-inline

此 API 不支持 EPUB 转 PDF/Markdown,也不支持不翻译的 PDF 转 PDF。

保留原文语言

PDF 转 EPUB 时,省略 target_language:

json
{"output_format":"epub"}

输出 Markdown ZIP 则使用 "output_format":"markdown"。不翻译时,rendering_mode 默认是 source,不能提供翻译提示或双语模式。

翻译文档

将 PDF 或 EPUB 翻译为英文 EPUB:

json
{  "output_format": "epub",  "target_language": "en",  "rendering_mode": "bilingual",  "translation_prompt": "Keep product names unchanged."}

replace 仅输出译文,是翻译时的默认值。bilingual 按文本块追加译文;bilingual-inline 在同一文本流内追加译文。这两种模式均不生成左右双栏 PDF。

输出翻译后的 PDF:

json
{"output_format":"pdf","target_language":"en","rendering_mode":"replace"}

可通过 translation_prompt 指定术语或人名的译法。该字段可省略;填写时不能全为空白,服务会去除首尾空白。它不支持指定模型。

请求中包含未知字段,或参数不适用于当前转换时,返回 400 INVALID_REQUEST。

PDF 脚注

footnotes行为
disabled禁用脚注提取,默认值
basic基础脚注提取
refined精细脚注处理
json
{"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、语言全名以及带首尾空白的值都会被拒绝。

HTTP 字段与响应码见接口参考,中断和失败后的处理见任务生命周期。