翻譯任務 API
查詢翻譯任務
查詢翻譯任務的狀態和詳情。
- 完整地址
- https://otranslator.com/api/v1/translation/query
- 認證
- 需要在 Authorization 請求頭中傳入 API Key
- Content-Type
- application/json
- 錯誤格式
- { "error": "Invalid API key." }
注意事項
建議在任務狀態為 Waiting 或 Processing 時輪詢該介面，狀態進入 Completed、Terminated 或 Cancelled 後停止輪詢。
下載連結為臨時存取地址，請在業務側按需儲存檔案或重新查詢獲取。
範例
1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'請求參數
| 參數 | 類型 | 預設 | 描述 | 範例 |
|---|---|---|---|---|
| *taskId | String | - | 翻譯任務ID | - |
響應
| 參數 | 類型 | 預設 | 描述 | 範例 |
|---|---|---|---|---|
| taskId | String | - | 任務ID | - |
| model | String | - | 翻譯時使用的模型 | - |
| fromLang | String | - | 原語言 | - |
| toLang | String | - | 目標語言 | - |
| status | String | - | 狀態: '初始化' | '等待中' | '處理中' | '已完成' | '已終止' | '已取消' | - |
| progress | Number | - | 進度，0~100 | - |
| errorMsg | String | - | 錯誤訊息 | - |
| fileTitle | String | - | 原文件名 | - |
| fileUrl | String | - | 原文件下載地址 | - |
| translatedFileUrl | String | - | 譯文的下載地址 | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | 可編輯譯文文件下載地址。僅在對應文件類型生成可編輯結果時返回。 | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | 文件統計詞數。不同檔案類型可能為空。 | - |
| price | Integer | - | 整體翻譯所需的Credits數 | - |
| usedCredits | Integer | - | 翻譯任務已使用的Credits數 | - |
| glossary | String[] | - | 翻譯任務使用的術語表名稱 | - |
| shouldTranslateImage | Boolean | - | 是否翻譯文檔中的圖片 | - |
| forceOCR | Boolean | - | 是否強制使用 OCR 識別文檔內容 | - |
| createdAt | DateTime | - | 翻譯任務的建立時間 | - |
| updatedAt | DateTime | - | 翻譯任務的更新時間 | - |
常見錯誤
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
404 Task not found.
The task does not exist, has been deleted, does not belong to the current API account, or was not created through the API.