Image Translation (Text)

Prev Next

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)의 언어 코드
  • auto(자동 언어 감지) | ko(한국어) | en(영어) | ja(일본어) | zh-CN(중국어(간체)) | zh-TW중국어(번체) | vi(베트남어) | th(태국어) | id(인도네시아어) | fr(프랑스어) | es(스페인어) | ru(러시아어)
target String Required 번역할 텍스트(Target)의 언어 코드
  • ko(한국어) | en(영어) | ja(일본어) | zh-CN(중국어(간체)) | zh-TW중국어(번체) | vi(베트남어) | th(태국어) | id(인도네시아어) | fr(프랑스어) | es(스페인어) | ru(러시아어) | de(독일어) | it(이탈리아어)
image JPG, JPEG, PNG, TIFF Required 원본 이미지 파일
참고

소스 언어를 특정 언어로 지정하지 않더라도(auto로 지정) 자동으로 언어를 감지하여 번역 결과를 제공합니다. 이 경우, 언어 감지에 대한 추가 과금 없이 번역 요청 글자 수 기준으로만 과금합니다.

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://papago.apigw.gov-ntruss.com/image-to-text/v1/translate' \
--header 'X-NCP-APIGW-API-KEY-ID: {앱 등록 시 발급받은 Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {앱 등록 시 발급 받은 Client Secret}' \
--header 'Content-Type: multipart/form-data' \
--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 값

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
    }
}