API Tác vụ Dịch thuật
Dịch văn bản
Dịch văn bản và trả về kết quả dịch đồng bộ.
- Địa chỉ đầy đủ
- https://otranslator.com/api/v1/translation/translateTexts
- 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 ý
API này sẽ lưu tạm thời văn bản truyền vào dưới dạng tài liệu JSON và xử lý đồng bộ, phù hợp cho dịch tức thì văn bản số lượng nhỏ.
Số dư điểm tài khoản cần ít nhất 2 credits. Nếu chi phí thực tế vượt quá số dư, giao diện sẽ trả về taskId và price, đồng thời thông báo số dư không đủ.
Ví dụ
1curl -X POST 'https://otranslator.com/api/v1/translation/translateTexts' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "texts": [
6 "string"
7 ],
8 "fromLang": "[string]",
9 "toLang": "[string]"
10}'Tham Số Yêu Cầu
| Tham số | Loại | Mặc Định | Mô Tả | Ví dụ |
|---|---|---|---|---|
| *texts | String[] | - | Văn bản cần dịch | - |
| *fromLang | String | - |
| - |
| *toLang | String | - |
| - |
| model | String | - |
| - |
| fileDescription | String | - | Mô tả tài liệu, thông qua việc cung cấp thông tin bổ sung để nâng cao chất lượng dịch thuật, ví dụ như bổ sung thông tin bối cảnh tài liệu và các yêu cầu dịch thuật khác | - |
Phản Hồi
| Tham số | Loại | Mặc Định | Mô Tả | Ví dụ |
|---|---|---|---|---|
| taskId | String | - | ID tác vụ | - |
| translatedTexts | String[] | - | Văn bản đã được dịch | - |
| 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 | - |
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.
402 Insufficient credits balance.
The account does not have enough credits to translate the texts.
400 Missing required parameter: fromLang.
Provide fromLang using a language returned by /api/v1/languages.
400 Missing required parameter: toLang.
Provide toLang using a language returned by /api/v1/languages.
400 Missing required parameter: texts.
Provide a non-empty texts array.
400 Failed to translate texts.
The text translation task could not be processed.