---
title: "Image Translation (Text)"
slug: "ai-naver-imagetotextapi"
tags: ["Papago Image Translation"]
updated: 2026-04-23T08:55:34Z
published: 2026-04-23T09:02:14Z
---

> ## 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 (Text)

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

입력된 JPG, JPEG, PNG, TIFF 형식의 이미지 내 텍스트를 인식(OCR)하여 번역 텍스트를 제공합니다.

참고

API 사용 시 다음 사항을 참고해 주십시오.

- 이미지 크기가 작으면 번역 결과 품질이 떨어질 수 있습니다. 장축 기준 1,280px 이상인 이미지 사용을 권장합니다.
- 왜곡된 이미지, 필기체 글자, 작은 크기의 글자, 배경색과 글자색이 유사한 이미지를 사용하면 번역 품질에 영향을 줄 수 있습니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| POST | /v1/translate |

### 요청 헤더

Papago Image Translation API에서 공통으로 사용하는 헤더에 대한 정보는 [Papago Image Translation 요청 헤더](/docs/ai-naver-papagoimagetranslation#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 바디

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `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.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 | - | 블록 단위 텍스트 인식 세부 정보: [blocks](/docs/ai-naver-imagetotextapi#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 값 |

#### `blocks`

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `sourceLang` | String | - | 원본 텍스트 언어 코드 |
| `sourceText` | String | - | 원본 텍스트 |
| `targetText` | String | - | 번역한 텍스트 |
| `lines` | Array | - | Line 단위 텍스트 인식 세부 정보: [lines](/docs/ai-naver-imagetotextapi#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](/docs/ai-naver-imagetotextapi#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#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
    "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
    }
}
```