Image Translation (Text)

Available in Classic and VPC

Recognize (OCR) text in images in JPG, JPEG, PNG, and TIFF formats and provide translated text.

Request

The following describes the request format for the endpoint. The request format is as follows:

Request headers

For headers common to all Papago Image Translation APIs, see Common Papago Image Translation headers.

Request body

The following describes the request body.

Request example

The following is a sample request.

curl --location --request POST 'https://naveropenapi.apigw.ntruss.com/image-to-text/v1/translate' \
--header 'X-NCP-APIGW-API-KEY-ID: {Client ID issued when registering the app}' \
--header 'X-NCP-APIGW-API-KEY: {Client secret issued when registering the app}' \
--header 'Content-Type: multipart/form-data' \
--form 'source="auto"' \
--form 'target="ko"' \
--form 'image=@"{image}"'

Response

The following describes the response format.

Response body

The following describes the response body.

blocks

The following describes blocks.

lines

The following describes lines.

words

The following describes words.

Response status codes

For response status codes common to all Papago Image Translation APIs, see Common Papago Image Translation response status codes.

Response example

The following is a sample example.

{
    "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": "U.S. Department of State, Language Services Translation Division\nEnglish => Foriegn language, set 1\nGeneral category (231 words)\nTranslate all of the following:\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": "The two chambers have very similar concerns regarding local and special interest legislation, complex legislative and parliamentary procedures, and a tendency to vote by blocs and interest groups ignoring party affiliations. However, both upper chambers have their own unique characteristics.",
                "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
    }
}