번역 작업 API
번역 작업 조회
번역 작업의 상태와 세부 정보를 조회합니다.
- 전체 주소
- https://otranslator.com/api/v1/translation/query
- 인증
- Authorization 요청 헤더에 API Key를 전달해야 합니다
- Content-Type
- application/json
- 잘못된 형식
- { "error": "Invalid API key." }
주의사항
작업 상태가 Waiting 또는 Processing일 때 해당 인터페이스를 폴링하고, 상태가 Completed, Terminated 또는 Cancelled로 진입한 후 폴링을 중지할 것을 권장합니다.
다운로드 링크는 임시 접근 주소이므로, 비즈니스 측에서 필요에 따라 파일을 저장하거나 재조회하여 획득하시기 바랍니다.
예시
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}'요청 매개변수
| 매개변수 | 유형 | 기본값 | 설명 | 예시 |
|---|---|---|---|---|
| *taskId | String | - | 번역 작업 ID | - |
응답
| 매개변수 | 유형 | 기본값 | 설명 | 예시 |
|---|---|---|---|---|
| taskId | String | - | 작업 ID | - |
| model | String | - | 번역 시 사용된 모델 | - |
| fromLang | String | - | 원본 언어 | - |
| toLang | String | - | 대상 언어 | - |
| status | String | - | 상태: 'Init' | 'Waiting' | 'Processing' | 'Completed' | 'Terminated' | 'Cancelled' | - |
| progress | Number | - | 진행률, 0~100 | - |
| errorMsg | String | - | 오류 정보 | - |
| fileTitle | String | - | 원본 파일명 | - |
| fileUrl | String | - | 원본 파일 다운로드 주소 | - |
| translatedFileUrl | String | - | 번역문 다운로드 주소 | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | 편집 가능한 번역문 파일 다운로드 주소. 해당 파일 형식이 편집 가능한 결과를 생성할 때만 반환됩니다. | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | 문서의 단어 수 통계. 파일 유형에 따라 비어 있을 수 있음. | - |
| price | Integer | - | 전체 번역에 필요한 Credits 수 | - |
| usedCredits | Integer | - | 번역 작업 사용 Credits 수 | - |
| glossary | String[] | - | 번역 작업 사용 용어집 명칭 | - |
| shouldTranslateImage | Boolean | - | 문서 내 이미지 번역 여부 | - |
| forceOCR | Boolean | - | 문서 내용 인식에 OCR 강제 사용 여부 | - |
| createdAt | DateTime | - | 번역 작업 생성 시간 | - |
| updatedAt | DateTime | - | 번역 작업 업데이트 시간 | - |
일반적인 오류
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.