建立翻譯

創建一個翻譯任務。

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、British English、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、Javanese、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	可選模型: gemini-2.0-flash \| gemini-pro \| gemini-2.5-pro \| claude-haiku \| claude-3.7-sonnet \| gpt-4.1-mini \| gpt-4.1 \| o4-mini \| deepseek-v3 \| deepseek-r1 \| grok-3-mini \| grok-3 \| llama-4-maverick
*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