Tạo bản dịch
Tạo một nhiệm vụ dịch thuật.
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'Tham số yêu cầu
Ngôn ngữ hỗ trợ:
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
| Tham số | Loại | Mô tả |
|---|---|---|
| *fromLang | String | Ngôn ngữ gốc, ngôn ngữ gốc không thể giống với ngôn ngữ đích, xem các ngôn ngữ được hỗ trợ |
| *toLang | String | Ngôn ngữ đích, ngôn ngữ đích không thể giống với ngôn ngữ gốc, xem ngôn ngữ được hỗ trợ |
| *model | String | Mô hình tùy chọn: 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 | Tệp cần dịch,Hỗ trợ các loại tệp tin: .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 | Giá trị hợp lệ: "true" hoặc "false". Có dịch hình ảnh trong tài liệu PDF hay không, giá trị mặc định là false |
| glossary | String | Tên bảng thuật ngữ được sử dụng trong dịch thuật |
| preview | String | Giá trị hợp lệ: "true" hoặc "false". Tạo bản xem trước dịch tài liệu bằng cách thanh toán 2 credits |
Phản hồi
| Tham số | Loại | Mô tả |
|---|---|---|
| taskId | String | ID của nhiệm vụ đã tạo |
Tra cứu bản dịch
Tra cứu nhiệm vụ dịch thuật, bao gồm trạng thái nhiệm vụ, liên kết đến tệp đã dịch
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]" }'Tham số yêu cầu
| Tham số | Loại | Mô tả |
|---|---|---|
| *taskId | String | ID nhiệm vụ dịch thuật |
Phản hồi
| Tham số | Loại | Mô tả |
|---|---|---|
| status | String | 'Waiting' | 'Processing' | 'Completed' | 'Terminated' |
| progress | integer | 0~100, Tiến độ nhiệm vụ dịch thuật |
| translatedFileUrl | String | Đường dẫn tải xuống tệp đã dịch, chỉ có hiệu lực khi dịch hoàn tất (status ='Completed') |
| translatedBilingualFileUrl | String | Liên kết tải xuống tệp song ngữ đã dịch, chỉ có hiệu lực khi dịch thuật hoàn tất (status ='Completed') |
| usedCredits | integer | Điểm tín dụng được sử dụng cho dịch thuật |
| tokenCount | integer | Số lượng Token tương ứng với văn bản trong tài liệu |
| glossary | String[] | Tên bảng thuật ngữ được sử dụng trong tài liệu |
Xóa bản dịch
Xóa nhiệm vụ dịch thuật và tài liệu liên quan. Nhiệm vụ dịch thuật được tạo bởi API sẽ tự động bị xóa sau 7 ngày.
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]" }'Tham số yêu cầu
| Tham số | Loại | Mô tả |
|---|---|---|
| *taskId | String | ID của nhiệm vụ dịch thuật cần xóa |