创建翻译
创建一个翻译任务。
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 |