translate (문서 번역 요청)
- 인쇄
- PDF
translate (문서 번역 요청)
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
- 문서 파일 번역 요청 API (POST)
- 정상 업로드 시, Request ID를 발급 → Status/Download API 호출 시 사용
- 번역 진행 단계에 있는 문서를 포함하여 최대 5개의 API 동시 호출 가능
Header
| Name | Description |
|---|---|
| Content-Type | multipart/form-data 형식으로 전송 필요 |
| X-NCP-APIGW-API-KEY-ID | NCP 앱 등록 시 발급받은 Client ID |
| X-NCP-APIGW-API-KEY | NCP 앱 등록 시 발급받은 Secret Key |
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| source | String{ko,ja,en,zh-CN} | true | 소스 언어 코드 * auto 설정 시, 자동으로 소스 언어 감지 |
| target | String{ko,ja,en,zh-CN} | true | 타겟 언어 코드 |
| file | File | true | 번역할 파일 |
| glossaryKey | String | false | - 클라우드 콘솔에서 용어집 기능을 사용하는 경우, 해당 용어집의 glossary_key에 대응 (ex. 6ae8eba5-3154-4646-bc16-1c96532082e6) - 용어집 데이터를 기반으로 치환 번역 적용 - 한⇔영/한⇔일/한⇔중(간체)/영⇔일 가능 |
Response
json 형식으로 리턴
| Field Name | Type | Description |
|---|---|---|
| data | JSON Object | |
| data requestid | String | 요청한 파일 번역에 대한 Request id 발급 |
요청 성공 시 Example
{
"data": {
"requestId": "20201007_2522985202669_001"
}
}
오류 코드
{
"error": {
"errorCode": "25001",
"message": "API call failed"
}
}
| HttpStatusCode | code | message | Description |
|---|---|---|---|
| 400 | 00006 | API call failed | 지원하지 않는 언어쌍, 파일 확장자로의 요청 |
| 400 | 25010 | invalid glossary key | 유효하지 않은 glossary key |
| 500 | 25001 | API call failed | 내부 서버 에러 |
| 413 | 25004 | Request Entity Too Large | 제한된 파일 용량 초과 (100MB) |
| 429 | 25005 | Too many requests | 동시 번역 요청 수 초과 |
CURL Example
$ curl -X POST -F file=@a.xlsx -F source=ko -F target=en 'https://naveropenapi.apigw.gov-ntruss.com/doc-trans/v1/translate'
{"data":{"requestId":"20201007_2522985202669"}}
이 문서가 도움이 되었습니까?