API Tugas Terjemahan
Kueri tugas terjemahan
Kueri status dan detail tugas penerjemahan.
- Alamat lengkap
- https://otranslator.com/api/v1/translation/query
- Autentikasi
- Perlu menyertakan API Key di header permintaan Authorization
- Content-Type
- application/json
- Format error
- { "error": "Invalid API key." }
Hal-hal yang Perlu Diperhatikan
Disarankan untuk melakukan polling terhadap interface ini ketika status tugas adalah Waiting atau Processing, dan menghentikan polling setelah status masuk ke Completed, Terminated, atau Cancelled.
Tautan unduhan merupakan alamat akses sementara, silakan simpan file sesuai kebutuhan di sisi bisnis atau lakukan kueri ulang untuk mendapatkannya.
Contoh
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}'Parameter Permintaan
| Parameter | Jenis | Bawaan | Deskripsi | Contoh |
|---|---|---|---|---|
| *taskId | String | - | ID tugas penerjemahan | - |
Respons
| Parameter | Jenis | Bawaan | Deskripsi | Contoh |
|---|---|---|---|---|
| taskId | String | - | ID Tugas | - |
| model | String | - | Model yang digunakan untuk terjemahan | - |
| fromLang | String | - | Bahasa Sumber | - |
| toLang | String | - | Bahasa target | - |
| status | String | - | Status: 'Init' | 'Menunggu' | 'Memproses' | 'Selesai' | 'Dihentikan' | 'Dibatalkan' | - |
| progress | Number | - | Progres, 0~100 | - |
| errorMsg | String | - | Informasi kesalahan | - |
| fileTitle | String | - | Nama file asli | - |
| fileUrl | String | - | Alamat unduhan file asli | - |
| translatedFileUrl | String | - | Alamat unduhan hasil terjemahan | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Alamat unduhan file terjemahan yang dapat diedit. Hanya dikembalikan ketika menghasilkan hasil yang dapat diedit untuk jenis file yang sesuai. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Statistik jumlah kata dokumen. Mungkin kosong untuk beberapa jenis file. | - |
| price | Integer | - | Jumlah Credits yang diperlukan untuk keseluruhan terjemahan | - |
| usedCredits | Integer | - | Jumlah Credits yang telah digunakan tugas terjemahan | - |
| glossary | String[] | - | Nama glosarium yang digunakan tugas terjemahan | - |
| shouldTranslateImage | Boolean | - | Apakah menerjemahkan gambar dalam dokumen | - |
| forceOCR | Boolean | - | Paksa penggunaan OCR untuk mengenali konten dokumen | - |
| createdAt | DateTime | - | Waktu pembuatan tugas terjemahan | - |
| updatedAt | DateTime | - | Waktu pembaruan tugas terjemahan | - |
Kesalahan Umum
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.