创建翻译
创建一个翻译任务。
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'
Request Parameters
支持语言:
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、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)、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、Any Language
- *fromLang - String - 原语言,原语言不能和目标语言相同,见支持语言
- *toLang - String - 目标语言,目标语言不能和原语言相同,见支持语言
- *model - String - 可选模型: gpt-4o-mini | gpt-4o | gemini-flash | gemini-pro | claude-haiku | claude-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 来生成文档翻译的预览
Response
- 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]" }'
Request Parameters
- *taskId - String - 翻译任务ID
Response
- 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]" }'
Request Parameters
- *taskId - String - 需要删除的翻译任务ID