API Tugasan Terjemahan
Pertanyaan tugas terjemahan
Pertanyaan status dan butiran tugasan terjemahan.
- Alamat lengkap
- https://otranslator.com/api/v1/translation/query
- Pengesahan
- Perlu memasukkan API Key dalam pengepala permintaan Authorization
- Content-Type
- application/json
- Format salah
- { "error": "Invalid API key." }
Perkara Perhatian
Disyorkan untuk polling antara muka ini apabila status tugas adalah Waiting atau Processing, hentikan polling selepas status memasuki Completed, Terminated atau Cancelled.
Pautan muat turun adalah alamat akses sementara, sila simpan fail mengikut keperluan di sisi perniagaan atau dapatkan semula melalui pertanyaan baharu.
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 | Lalai | Keterangan | Contoh |
|---|---|---|---|---|
| *taskId | String | - | ID tugas penterjemahan | - |
Respons
| Parameter | Jenis | Lalai | Keterangan | Contoh |
|---|---|---|---|---|
| taskId | String | - | ID Tugasan | - |
| model | String | - | Model yang digunakan untuk terjemahan | - |
| fromLang | String | - | Bahasa Asal | - |
| toLang | String | - | Bahasa Sasaran | - |
| status | String | - | Status: 'Init' | 'Menunggu' | 'Memproses' | 'Selesai' | 'Ditamatkan' | 'Dibatalkan' | - |
| progress | Number | - | Kemajuan, 0~100 | - |
| errorMsg | String | - | Maklumat ralat | - |
| fileTitle | String | - | Nama fail asal | - |
| fileUrl | String | - | Alamat muat turun fail asal | - |
| translatedFileUrl | String | - | Alamat muat turun terjemahan | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | Alamat muat turun fail terjemahan boleh edit. Hanya dikembalikan apabila hasil boleh edit dijana untuk jenis fail sepadan. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | Statistik kiraan perkataan dokumen. Mungkin kosong untuk jenis fail yang berbeza. | - |
| price | Integer | - | Jumlah Credits yang diperlukan untuk keseluruhan terjemahan | - |
| usedCredits | Integer | - | Bilangan Credits yang telah digunakan untuk tugas terjemahan | - |
| glossary | String[] | - | Nama glosari yang digunakan untuk tugas terjemahan | - |
| shouldTranslateImage | Boolean | - | Adakah untuk menterjemah imej dalam dokumen | - |
| forceOCR | Boolean | - | Sama ada memaksa penggunaan OCR untuk mengenal pasti kandungan dokumen | - |
| createdAt | DateTime | - | Masa penciptaan tugas terjemahan | - |
| updatedAt | DateTime | - | Masa kemas kini tugasan terjemahan | - |
Ralat Biasa
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.