- 인쇄
- PDF
Papago Image Translation 개요
- 인쇄
- PDF
개요
Papago Image Translation API는 입력된 이미지 상의 텍스트를 인식하고, OCR 정보, 번역 텍스트, 번역 이미지 등을 제공하는 이미지 번역 REST API입니다.
API는 번역 결과 형태에 따라, Image Translation(Text) API와 Image Translation(Image) API의 2가지로 제공됩니다.
- 소스 언어: 한국어, 영어, 일본어, 중국어(간체, 번체), 베트남어, 태국어, 인도네시아어, 프랑스어, 스페인어, 러시아어
- 타겟 언어: 한국어, 영어, 일본어, 중국어(간체, 번체), 베트남어, 태국어, 인도네시아어, 프랑스어, 스페인어, 러시아어, 독일어, 이탈리아어
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·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다.
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 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 | 서버 내부 에러 |
언어 | 언어 코드 |
---|---|
한국어 | ko |
영어 | en |
일본어 | ja |
중국어 간체 | zh-CN |
중국어 번체 | zh-TW |
베트남어 | vi |
태국어 | th |
인도네시아어 | id |
프랑스어 | fr |
스페인어 | es |
러시아어 | ru |
독일어 | de |
이탈리아어 | it |
- 파일 포맷 : jpg, jpeg, png, tiff
- 파일 용량 : 최대 20MB
- 이미지 사이즈 : 최대 1960 x 1960
사용시 주의 사항
- 사이즈가 작은 이미지의 경우, 이미지 번역 결과 품질이 떨어질 수 있습니다. 이미지의 장축 기준으로 1,280 px 이상의 이미지를 사용하시는 것을 권장합니다.
- 왜곡된 이미지, 필기체 글자, 작은 크기의 글자, 배경색과 글자색이 유사한 경우 이미지 번역 품질에 영향을 줄 수 있습니다.
공통 설정
클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.
콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 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 | 리소스가 존재하지 않음 |
429 | 00005 | Exceed max request limit | API 제한 Rate 초과 |
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 processing error | 이미지 처리 중 에러 |
500 | 26006 | Image processing error | 이미지 처리 중 에러 |
500 | 26007 | Image processing error | 이미지 처리 중 에러 |
500 | 26008 | Server process error | 서버 프로세스 에러 |
500 | 26009 | Server Response Empty | 서버 응답 빈값 |
500 | 26099 | Unknown error | 서버 내부 에러 |