API Tác vụ Dịch thuật
Truy vấn nhiệm vụ dịch thuật
Truy vấn trạng thái và thông tin chi tiết của tác vụ dịch thuật.
- Địa chỉ đầy đủ
- https://otranslator.com/api/v1/translation/query
- Xác thực
- Cần truyền API Key vào request header Authorization
- Content-Type
- application/json
- Lỗi định dạng
- { "error": "Invalid API key." }
Lưu ý
Khuyến nghị thăm dò giao diện này khi trạng thái nhiệm vụ là Waiting hoặc Processing, dừng thăm dò sau khi trạng thái chuyển sang Completed, Terminated hoặc Cancelled.
Liên kết tải xuống là địa chỉ truy cập tạm thời, vui lòng lưu tệp theo nhu cầu hoặc truy vấn lại để lấy.
Ví dụ
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}'Tham Số Yêu Cầu
| Tham số | Loại | Mặc Định | Mô Tả | Ví dụ |
|---|---|---|---|---|
| *taskId | String | - | ID nhiệm vụ dịch thuật | - |
Phản Hồi
| Tham số | Loại | Mặc Định | Mô Tả | Ví dụ |
|---|---|---|---|---|
| taskId | String | - | ID tác vụ | - |
| model | String | - | Mô hình được sử dụng trong quá trình dịch | - |
| fromLang | String | - | Ngôn ngữ nguồn | - |
| toLang | String | - | Ngôn ngữ đích | - |
| status | String | - | Trạng thái: 'Init' | 'Waiting' | 'Processing' | 'Completed' | 'Terminated' | 'Cancelled' | - |
| progress | Number | - | Tiến độ, 0~100 | - |
| errorMsg | String | - | Thông tin lỗi | - |
| fileTitle | String | - | Tên tệp gốc | - |
| fileUrl | String | - | Địa chỉ tải xuống tệp gốc | - |
| translatedFileUrl | String | - | Địa chỉ tải xuống bản dịch | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Địa chỉ tải xuống tệp bản dịch có thể chỉnh sửa. Chỉ trả về khi tạo kết quả có thể chỉnh sửa cho loại tệp tương ứng. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Thống kê số từ tài liệu. Có thể trống với các loại tệp khác nhau. | - |
| price | Integer | - | Tổng số Credits cần thiết cho việc dịch thuật | - |
| usedCredits | Integer | - | Số Credits đã sử dụng cho nhiệm vụ dịch thuật | - |
| glossary | String[] | - | Tên bảng thuật ngữ được sử dụng cho nhiệm vụ dịch thuật | - |
| shouldTranslateImage | Boolean | - | Có dịch hình ảnh trong tài liệu không | - |
| forceOCR | Boolean | - | Có cưỡng chế sử dụng OCR để nhận diện nội dung tài liệu hay không | - |
| createdAt | DateTime | - | Thời gian tạo nhiệm vụ dịch thuật | - |
| updatedAt | DateTime | - | Thời gian cập nhật của nhiệm vụ dịch thuật | - |
Lỗi thường gặp
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.