Papago Image Translation API는 입력된 이미지 속 텍스트를 인식하고 OCR 정보, 번역 텍스트, 번역 이미지 등을 제공하는 이미지 번역 REST API입니다. API는 번역 결과 형태에 따라 Image Translation(Text)과 Image Translation(Image) API로 제공됩니다.
- 지원 언어
- 소스 언어: 한국어, 영어, 일본어, 중국어(간체, 번체), 베트남어, 태국어, 인도네시아어, 프랑스어, 스페인어, 러시아어
- 타깃 언어: 한국어, 영어, 일본어, 중국어(간체, 번체), 베트남어, 태국어, 인도네시아어, 프랑스어, 스페인어, 러시아어, 독일어, 이탈리아어
- 파일 포맷: jpg, jpeg, png, tiff
- 파일 용량: 최대 20MB
- 이미지 사이즈: 최대 1960 x 1960
참고
- 이미지 사이즈가 작으면 번역 결과 품질이 떨어질 수 있습니다. 장축 기준 1,280 px 이상의 이미지를 사용하는 것을 권장합니다.
- 왜곡된 이미지, 필기체 글자, 작은 크기의 글자, 배경색과 글자색이 유사한 이미지를 사용하면 번역 품질에 영향을 줄 수 있습니다.
공통 설정
-
클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급해 주십시오.
-
콘솔의 AI Service > Papago Translation > APIs에서 애플리케이션을 등록해 주십시오.
-
AI Service > Papago Translation > APIs에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인해 주십시오.
-
AI Service > Papago Translation > APIs의 변경 화면에서 Papago Image Translation이 선택되어 있는지 확인해 주십시오. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하 주의해 주십시오.
공통 오류
| HttpStatusCode | ErrorCode | ErrorMessage | Description |
|---|---|---|---|
| 400 | 100 | Bad Request Exception | protocol(https), endocing(UTF-8) 등 request 오류 |
| 401 | 200 | Authentication Failed | 인증실패 |
| 401 | 210 | Permission Denied | 권한없음 |
| 404 | 300 | Not Found Exception | 권한없음 |
| 429 | 400 | Quota Exceeded | Quota 초과 |
| 429 | 410 | Throttle Limited | Rate 초과 |
| 429 | 420 | Rate Limited | Rate 초과 |
| 413 | 430 | Request Entity Too Large | content-length 초과 (10MB) |
| 503 | 500 | Endpoint Error | 엔드포인트 연결오류 |
| 504 | 510 | Endpoint Timeout | 엔드포인트 연결시간 초과 |
| 500 | 900 | Unexpected Error | 예외처리가 안된 오류 |
API 오류
| HttpStatusCode | ErrorCode | ErrorMessage | Description |
|---|---|---|---|
| 404 | 00000 | API call failed | API 호출 실패 |
| 400 | 00001 | Request is invalid | 유효하지 않은 호출 |
| 404 | 00003 | Not Found | 리소스가 존재하지 않음 |
| 400 | 26000 | No Image | 이미지가 존재하지 않음 |
| 400 | 26001 | Unsupported language | 지원하지 않는 언어 |
| 413 | 26002 | Exceed max file size | 파일 용량 20MB 초과 |
| 400 | 26003 | Unknown image type | 지원하지 않는 이미지 형식 |
| 413 | 26004 | Exceed max image size | 이미지 width or height 제한 초과 |
| 500 | 26005 | Image serving error | 이미지 서빙 에러 |
| 500 | 26007 | Image no text | 텍스트가 존재하지 않음 |
| 500 | 26099 | Unknown error | 서버 내부 에러 |