创建翻译

创建一个翻译任务。

1curl -X POST 'https://otranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'fromLang=English' \
4--form 'toLang=Simplified Chinese' \
5--form 'glossary=[GlossaryName]' \
6--form 'file=@bitcoin.pdf'

请求参数

支持语言：
English、Simplified Chinese、Traditional Chinese (Hong Kong)、Traditional Chinese (Taiwan)、Traditional Chinese、Spanish、Portuguese、Russian、Italian、French、German、Ukrainian、Swedish、Japanese、Japanese (Honorifics)、Japanese (Humble)、Japanese (Polite)、Polish、Turkish、Korean、Malay、Lao、Thai、Vietnamese、Bengali、Burmese、Finnish、Georgian、Greek、Albanian、Arabic、Armenian、Azerbaijani、Belarusian、Bosnian、Bulgarian、Canadian French、Catalan、Croatian、Czech、Danish、Dutch、Estonian、Filipino、Gujarati、Haitian Creole、Hebrew、Hindi、Hungarian、Icelandic、Indonesian、Irish、Kazakh、Khmer、Latin、Latin American Spanish、Brazilian Portuguese、Latvian、Lithuanian、Macedonian、Maltese、Mongolian (Cyrillic)、Montenegrin、Norwegian、Persian、Romanian、Serbian (Cyrillic letters)、Serbian (Latin letters)、Sinhala、Slovak、Slovenian、Swahili、Tamil、Telugu、Oriya、Kannada、Punjabi、Marathi、Malayalam、Uzbek、Urdu、Amharic、Uyghur、Cantonese、Yiddish、Tigrinya、Turkmen (Latin letters)、Turkmen (Cyrillic letters)、Any Language

参数	类型	描述
*fromLang	String	原语言，原语言不能和目标语言相同，见支持语言
*toLang	String	目标语言，目标语言不能和原语言相同，见支持语言
*model	String	可选模型: gpt-4o-mini \| gpt-4o \| o3-mini \| gemini-2.0-flash \| gemini-pro \| claude-haiku \| claude-3.7-sonnet
*file	binary	需要翻译的文件，支持文件类型： .PDF .DOCX .XLSX .PPTX .EPUB .PO .SRT .TXT .HTML .ZIP .XML .XLF .GO .JPG .JPEG .PNG .MD .ODT .ODS .ODP .CSV .TSV .YAML .PHP .AI
shouldTranslateImage	String	有效值: "true" 或 "false"。是否翻译PDF文档中的图片, 默认值为false
glossary	String	翻译时使用的术语表名称
preview	String	有效值: "true" 或 "false". 通过支付 2 credits 来生成文档翻译的预览

响应

参数	类型	描述
taskId	String	创建任务的id

查询翻译

查询翻译任务，包含任务状态、已翻译文件链接

1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data  '{ "taskId": "[created taskId]" }'

请求参数

参数	类型	描述
*taskId	String	翻译任务ID

响应

参数	类型	描述
status	String	'Waiting' \| 'Processing' \| 'Completed' \| 'Terminated'
progress	integer	0~100, 翻译任务进度
translatedFileUrl	String	翻译文件下载链接，只有翻译完成时（status ='Completed'）有效
translatedBilingualFileUrl	String	翻译双语文件下载链接，只有翻译完成时（status ='Completed'）有效
usedCredits	integer	翻译使用的积分
tokenCount	integer	文档中的文本对应的Token数量
glossary	String[]	文档使用的术语表名称

删除翻译

删除翻译任务和相关文档。API创建的翻译任务会在7天后自动删除。

1curl -X POST 'https://otranslator.com/api/v1/translation/delete' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data  '{ "taskId": "[created taskId]" }'

请求参数

参数	类型	描述
*taskId	String	需要删除的翻译任务ID