文檔目錄

翻譯任務 API

建立翻譯任務

/v1/translation/create

建立新的文件/檔案翻譯任務。

範例

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

請求參數

參數類型預設描述範例
*filebinary-
  • 需要翻譯的檔案
  • 支援檔案類型：查詢
bitcoin.pdf
*fromLangString-
  • 原語言，原語言不能和目標語言相同
  • 支援語言：查詢
English
*toLangString-
  • 目標語言，目標語言不能和原語言相同
  • 支援語言：查詢
Simplified Chinese
modelString-
  • 翻譯的AI模型
  • 支援模型：查詢
-
fileDescriptionString-

文檔描述，透過提供額外資訊來提升翻譯品質，例如新增額外的文檔背景資訊和其他翻譯需求等

-
glossaryString-

翻譯時使用的術語表名稱

-
previewBooleanfalse

是否僅產生預覽。僅產生預覽時，透過支付 2 credits 來產生文檔翻譯預覽

-
shouldTranslateImageBooleanfalse
  • 是否翻譯文件中的圖片
  • 僅支援PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF
-
shouldTranslateFileNameBooleantrue

是否翻譯檔案名稱

-
passwordString-

PDF檔案的開啟密碼

-
ignoreCommentsBooleanfalse

是否忽略DOCX和PPTX、XLSX的批註

-
ignoreNotesBooleanfalse

是否忽略PPTX的備註

-
ignoreHeadersAndFootersBooleanfalse

是否忽略DOCX的頁腳和頁首

-
ignoreHiddenBooleanfalse

是否忽略PPTX的隱藏頁面

-
ignoreMastersBooleanfalse

是否忽略PPTX的母版文字

-
ignoreSheetNamesBooleanfalse

是否不翻譯XLSX的表名

-
extractTextRegExpPatternString-
  • 僅翻譯匹配正則表達式的內容，並將其替換為譯文
  • 僅支援txmsg
-
extractTextRegExpFlagsString-
  • 正則表達式的Flags: g, s, m, u, y
  • 僅支援txmsg
-
webhookUrlString-

狀態更新時的回調URL，回調的內容包含：{taskId, progress, status}

-

回應

參數類型預設描述範例
taskIdString-

任務ID

-
翻譯任務 API
查詢翻譯任務