--- title: "Image Translation (Image)" slug: "ai-naver-imagetoimageapi" tags: ["Papago Image Translation"] updated: 2026-09-17T09:15:50Z published: 2026-09-17T09:15:50Z canonical: "api.ncloud-docs.com/ai-naver-imagetoimageapi" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Image Translation (Image)

Classic/VPC 환경에서 이용 가능합니다.

입력된 JPG, JPEG, PNG, TIFF 형식의 이미지 내 텍스트를 인식(OCR)하여 번역 텍스트와 번역 이미지를 제공합니다. ::: (Info) (참고) API 사용 시 다음 사항을 참고해 주십시오. * 이미지 크기가 작으면 번역 결과 품질이 떨어질 수 있습니다. 장축 기준 1,280px 이상인 이미지 사용을 권장합니다. * 왜곡된 이미지, 필기체 글자, 작은 크기의 글자, 배경색과 글자색이 유사한 이미지를 사용하면 번역 품질에 영향을 줄 수 있습니다. ::: ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | :--- | :--- | | POST | /v1/translate | ### 요청 헤더 Papago Image Translation API에서 공통으로 사용하는 헤더에 대한 정보는 [Papago Image Translation 요청 헤더](/docs/ai-naver-papagoimagetranslation#요청헤더)를 참조해 주십시오. ### 요청 바디 요청 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `source` | String | Required | 원본 텍스트(Source)의 언어 코드 | | `target` | String | Required | 번역할 텍스트(Target)의 언어 코드 | | `image` | JPG, JPEG, PNG, TIFF | Required | 원본 이미지 파일 | ::: (Info) (참고) 소스 언어를 특정 언어로 지정하지 않더라도(`auto`로 지정) 자동으로 언어를 감지하여 번역 결과를 제공합니다. 이 경우, 언어 감지에 대한 추가 과금 없이 번역 요청 글자 수 기준으로만 과금합니다. ::: ### 요청 예시 요청 예시는 다음과 같습니다. ```shell curl --location --request POST 'https://papago.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: 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 | - | 블록 단위 텍스트 인식 세부 정보: [blocks](#datablockscontent) | | `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](#linescontent) | #### `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](#wordscontent) | #### `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 응답 상태 코드](/docs/ai-naver-papagoimagetranslation#응답상태코드)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ```json { "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}", } } ```