Classic/VPC 환경에서 이용 가능합니다.
Papago Image Translation은 제품 이미지, 금융 서류, 영수증 등 다양한 이미지에 포함된 텍스트를 인식하여 번역 결과를 제공하는 네이버 클라우드 플랫폼의 서비스입니다. OCR 정보, 번역 텍스트, 번역 이미지 제공 기능에 대한 API를 RESTful 형태로 제공합니다. 번역 결과 형태에 따라 Image Translation(Text)과 Image Translation(Image)으로 구분합니다.
- Papago Image Translation API는 사용자의 원문 데이터를 저장하거나 학습 데이터로 활용하지 않습니다.
- Papago Image Translation API의 지원 사양은 다음과 같습니다.
- 파일 포맷: *.jpg, *.jpeg, *.png, *.tiff
- 파일 용량: 최대 20MB
- 이미지 크기: 최대 1960x1960
Papago Image Translation 공통 설정
Papago Image Translation API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
Image Translation(Text):
https://papago.apigw.ntruss.com/image-to-text
Image Transaltion(Image):
https://papago.apigw.ntruss.com/image-to-image
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
| 필드 | 필수 여부 | 설명 |
|---|---|---|
x-ncp-apigw-api-key-id |
Required | 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client ID |
x-ncp-apigw-api-key |
Required | 네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client Secret |
Content-Type |
Required | 클라이언트가 처리 가능한 데이터 타입
|
네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 API 사용에 필요한 인증 정보(Client ID, Client Secret)를 발급받는 방법은 Papago Image Translation 사용 가이드의 Papago Image Translation 시작을 참조해 주십시오.
콘솔에서 Application 등록 후 Papago Image Translation API를 선택하지 않으면 429(Quota Exceed) 오류가 발생합니다.
응답
공통 응답 형식을 설명합니다.
응답 상태 코드
응답 상태 코드에 대한 설명은 다음과 같습니다.
네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.
| HTTP 상태 코드 | 코드 | 메시지 | 설명 |
|---|---|---|---|
| 404 | 00000 | API call failed | API 호출을 실패함 |
| 400 | 00001 | Request is invalid | API 호출이 유효하지 않음 |
| 404 | 00003 | Not Found | 리소스가 존재하지 않음 |
| 400 | 26000 | No Image | 이미지가 존재하지 않음 |
| 400 | 26001 | Unsupported language | source와 target 언어를 지원하지 않음 |
| 413 | 26002 | Exceed max file size | 허용되는 파일 용량을 초과함 (최대 20 MB) |
| 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 | 서버 내부 오류 |
Papago Image Translation API
Papago Image Translation 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.
| API | 설명 |
|---|---|
| Image Translation(Text) | 이미지 내 텍스트 인식, OCR 후 번역 결과 텍스트 제공 |
| Image Translation(Image) | 이미지 내 텍스트 인식, OCR 후 번역 결과 텍스트 및 이미지 제공 |
Papago Image Translation 연관 리소스
Papago Image Translation API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.
- Papago Image Translation API 사용 방법
- 서명(시그니처) 생성: 요청 헤더에 추가할 서명 생성 방법
- Ncloud 공통 응답 상태 코드: Papago Image Translation 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Cloud Insight 사용 가이드: Application 사용 한도 알림 설정에 필요한 Cloud Insight 이용 신청 방법 및 알림 통보 대상자 추가 방법 안내
- Sub Account 사용 가이드: Papago Image Translation의 운영 권한 관리를 도와주는 Sub Account 사용 방법 안내
- Papago Image Translation 서비스 사용 방법
- Papago Image Translation 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Papago Image Translation 서비스 이용 관련 안내, 사용량 확인 및 통보 설정 방법
- Papago Image Translation 사용 준비: Papago Image Translation에서 지원되는 환경 사양, 사용 시 유의 사항, 이용 요금 안내
- Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
- 요금 소개, 특징, 상세 기능: Papago Image Translation의 요금 체계, Papago Image Translation의 특징 및 상세 기능 요약
- 서비스 최신 소식: Papago Image Translation 관련 최신 소식
- 자주 하는 질문: Papago Image Translation 사용자들이 자주 하는 질문
- 문의하기: 사용 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의