Image Translation (Image)
- 인쇄
- PDF
Image Translation (Image)
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
입력된 JPG, JPEG, PNG, TIFF 형식의 이미지 내 텍스트를 인식(OCR)하여 번역 텍스트와 번역 이미지를 제공합니다.
참고
API 사용 시 다음 사항을 참고해 주십시오.
- 이미지 크기가 작으면 번역 결과 품질이 떨어질 수 있습니다. 장축 기준 1,280px 이상인 이미지 사용을 권장합니다.
- 왜곡된 이미지, 필기체 글자, 작은 크기의 글자, 배경색과 글자색이 유사한 이미지를 사용하면 번역 품질에 영향을 줄 수 있습니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
POST | /v1/translate |
요청 헤더
Papago Image Translation API에서 공통으로 사용하는 헤더에 대한 정보는 Papago Image Translation 공통 헤더를 참조해 주십시오.
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
source | String | Required | 원본 텍스트(Source)의 언어 코드
|
target | String | Required | 번역할 텍스트(Target)의 언어 코드
|
image | JPG, JPEG, PNG, TIFF | Required | 원본 이미지 파일 |
참고
소스 언어를 특정 언어로 지정하지 않더라도(auto
로 지정) 자동으로 언어를 감지하여 번역 결과를 제공합니다. 이 경우, 언어 감지에 대한 추가 과금 없이 번역 요청 글자 수 기준으로만 과금합니다.
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://naveropenapi.apigw.ntruss.com/image-to-image/v1/translate' \
--header 'X-NCP-APIGW-API-KEY-ID: {앱 등록 시 발급받은 Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {앱 등록 시 발급 받은 Client Secret}' \
--header 'Content-Type;' \
--form 'source="auto"' \
--form 'target="ko"' \
--form 'image=@"{image}"'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
data | Object | - | 응답 결과 |
data.sourceLang | String | - | 원본 텍스트 언어 코드 |
data.targetLang | String | - | 번역한 텍스트 언어 코드 |
data.sourceText | String | - | 원본 텍스트 |
data.targetText | String | - | 번역한 텍스트 |
data.blocks | Array | - | 블록 단위 텍스트 인식 세부 정보 |
data.LB | Object | - | Left Bottom(왼쪽 아래) 좌표 세부 정보 |
data.LB.x | Integer | - | Left Bottom 좌표 x 값 |
data.LB.y | Integer | - | Left Bottom 좌표 y 값 |
data.LT | Object | - | Left Top(왼쪽 위) 좌표 세부 정보 |
data.LT.x | Integer | - | Left Top 좌표 x 값 |
data.LT.y | Integer | - | Left Top 좌표 y 값 |
data.RB | Object | - | Right Bottom(오른쪽 아래) 좌표 세부 정보 |
data.RB.x | Integer | - | Right Bottom 좌표 x 값 |
data.RB.y | Integer | - | Right Bottom 좌표 y 값 |
data.RT | Object | - | Right Top(오른쪽 위) 좌표 세부 정보 |
data.RT.x | Integer | - | Right Top 좌표 x 값 |
data.RT.y | Integer | - | Right Top 좌표 y 값 |
data.renderedImage | String | - | 번역된 이미지의 바이너리 값
|
blocks
blocks
에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
sourceLang | String | - | 원본 텍스트 언어 코드 |
sourceText | String | - | 원본 텍스트 |
targetText | String | - | 번역한 텍스트 |
lines | Array | - | Line 단위 텍스트 인식 세부 정보 |
lines
lines
에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
LB | Object | - | Left Bottom(왼쪽 아래) 좌표 세부 정보 |
LB.x | Integer | - | Left Bottom 좌표 x 값 |
LB.y | Integer | - | Left Bottom 좌표 y 값 |
LT | Object | - | Left Top(왼쪽 위) 좌표 세부 정보 |
LT.x | Integer | - | Left Top 좌표 x 값 |
LT.y | Integer | - | Left Top 좌표 y 값 |
RB | Object | - | Right Bottom(오른쪽 아래) 좌표 세부 정보 |
RB.x | Integer | - | Right Bottom 좌표 x 값 |
RB.y | Integer | - | Right Bottom 좌표 y 값 |
RT | Object | - | Right Top(오른쪽 위) 좌표 세부 정보 |
RT.x | Integer | - | Right Top 좌표 x 값 |
RT.y | Integer | - | Right Top 좌표 y 값 |
words | Array | - | Word 단위 텍스트 인식 세부 정보 |
words
words
에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
sourceText | String | - | 원본 텍스트 |
LB | Object | - | Left Bottom(왼쪽 아래) 좌표 세부 정보 |
LB.x | Integer | - | Left Bottom 좌표 x 값 |
LB.y | Integer | - | Left Bottom 좌표 y 값 |
LT | Object | - | Left Top(왼쪽 위) 좌표 세부 정보 |
LT.x | Integer | - | Left Top 좌표 x 값 |
LT.y | Integer | - | Left Top 좌표 y 값 |
RB | Object | - | Right Bottom(오른쪽 아래) 좌표 세부 정보 |
RB.x | Integer | - | Right Bottom 좌표 x 값 |
RB.y | Integer | - | Right Bottom 좌표 y 값 |
RT | Object | - | Right Top(오른쪽 위) 좌표 세부 정보 |
RT.x | Integer | - | Right Top 좌표 x 값 |
RT.y | Integer | - | Right Top 좌표 y 값 |
응답 상태 코드
Papago Image Translation API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Papago Image Translation 공통 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"data": {
"sourceLang": "en",
"targetLang": "ko",
"sourceText": "U.S. Department of State Office of Language Services Translating Division\nEnglish=> Foreign Lang, Set 1\nGeneral Category (231 words)\nPlease translate everything below:\n",
"targetText": "미국 국무부 언어 서비스 번역 부서\n영어=> 외국어, 세트 1\n일반범주(231단어)\n아래의 모든 것을 번역해 주세요:\n",
"blocks": [
{
"sourceLang": "en",
"sourceText": "The two houses of Congress are much alike in their concern with local and special-interest legislation, their intricate legislative and parliamentary procedure, their tendency toward voting by blocks and interest groups in defiance of party ties. Yet the upper chamber has a character all its own.",
"targetText": "두 의회는 지역 및 특수 이익 입법, 복잡한 입법 및 의회 절차, 정당 관계를 무시하고 블록 및 이익 집단에 의해 투표하는 경향에 관한 관심사가 매우 비슷합니다. 그러나 상부 방은 모두 고유의 특성을 가지고 있습니다.",
"lines": [
{
"LB": {
"x": 156,
"y": 238
},
"LT": {
"x": 156,
"y": 220
},
"RB": {
"x": 637,
"y": 238
},
"RT": {
"x": 637,
"y": 221
},
"words": [
{
"sourceText": "houses",
"LB": {
"x": 213,
"y": 235
},
"LT": {
"x": 213,
"y": 220
},
"RB": {
"x": 261,
"y": 235
},
"RT": {
"x": 261,
"y": 220
}
}
]
}
]
}
],
"LB": {
"x": 108,
"y": 141
},
"LT": {
"x": 108,
"y": 91
},
"RB": {
"x": 280,
"y": 141
},
"RT": {
"x": 280,
"y": 91
},
"renderedImage": "{renderedImage}",
}
}
이 문서가 도움이 되었습니까?