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 공통 헤더를 참조해 주십시오.

    요청 바디

    요청 바디에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    sourceStringRequired원본 텍스트(Source)의 언어 코드
    • auto(자동 언어 감지) | ko(한국어) | en(영어) | ja(일본어) | zh-CN(중국어(간체)) | zh-TW중국어(번체) | vi(베트남어) | th(태국어) | id(인도네시아어) | fr(프랑스어) | es(스페인어) | ru(러시아어)
    targetStringRequired번역할 텍스트(Target)의 언어 코드
    • ko(한국어) | en(영어) | ja(일본어) | zh-CN(중국어(간체)) | zh-TW중국어(번체) | vi(베트남어) | th(태국어) | id(인도네시아어) | fr(프랑스어) | es(스페인어) | ru(러시아어) | de(독일어) | it(이탈리아어)
    imageJPG, JPEG, PNG, TIFFRequired원본 이미지 파일
    참고

    소스 언어를 특정 언어로 지정하지 않더라도(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}"'
    

    응답

    응답 형식을 설명합니다.

    응답 바디

    응답 바디에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    dataObject-응답 결과
    data.sourceLangString-원본 텍스트 언어 코드
    data.targetLangString-번역한 텍스트 언어 코드
    data.sourceTextString-원본 텍스트
    data.targetTextString-번역한 텍스트
    data.blocksArray-블록 단위 텍스트 인식 세부 정보
    data.LBObject-Left Bottom(왼쪽 아래) 좌표 세부 정보
    data.LB.xInteger-Left Bottom 좌표 x 값
    data.LB.yInteger-Left Bottom 좌표 y 값
    data.LTObject-Left Top(왼쪽 위) 좌표 세부 정보
    data.LT.xInteger-Left Top 좌표 x 값
    data.LT.yInteger-Left Top 좌표 y 값
    data.RBObject-Right Bottom(오른쪽 아래) 좌표 세부 정보
    data.RB.xInteger-Right Bottom 좌표 x 값
    data.RB.yInteger-Right Bottom 좌표 y 값
    data.RTObject-Right Top(오른쪽 위) 좌표 세부 정보
    data.RT.xInteger-Right Top 좌표 x 값
    data.RT.yInteger-Right Top 좌표 y 값
    data.renderedImageString-번역된 이미지의 바이너리 값
    • Base64 방식으로 인코딩 후 바이너리 형식으로 반환

    blocks

    blocks에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    sourceLangString-원본 텍스트 언어 코드
    sourceTextString-원본 텍스트
    targetTextString-번역한 텍스트
    linesArray-Line 단위 텍스트 인식 세부 정보

    lines

    lines에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    LBObject-Left Bottom(왼쪽 아래) 좌표 세부 정보
    LB.xInteger-Left Bottom 좌표 x 값
    LB.yInteger-Left Bottom 좌표 y 값
    LTObject-Left Top(왼쪽 위) 좌표 세부 정보
    LT.xInteger-Left Top 좌표 x 값
    LT.yInteger-Left Top 좌표 y 값
    RBObject-Right Bottom(오른쪽 아래) 좌표 세부 정보
    RB.xInteger-Right Bottom 좌표 x 값
    RB.yInteger-Right Bottom 좌표 y 값
    RTObject-Right Top(오른쪽 위) 좌표 세부 정보
    RT.xInteger-Right Top 좌표 x 값
    RT.yInteger-Right Top 좌표 y 값
    wordsArray-Word 단위 텍스트 인식 세부 정보

    words

    words에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    sourceTextString-원본 텍스트
    LBObject-Left Bottom(왼쪽 아래) 좌표 세부 정보
    LB.xInteger-Left Bottom 좌표 x 값
    LB.yInteger-Left Bottom 좌표 y 값
    LTObject-Left Top(왼쪽 위) 좌표 세부 정보
    LT.xInteger-Left Top 좌표 x 값
    LT.yInteger-Left Top 좌표 y 값
    RBObject-Right Bottom(오른쪽 아래) 좌표 세부 정보
    RB.xInteger-Right Bottom 좌표 x 값
    RB.yInteger-Right Bottom 좌표 y 값
    RTObject-Right Top(오른쪽 위) 좌표 세부 정보
    RT.xInteger-Right Top 좌표 x 값
    RT.yInteger-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}",
        }
    }
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.