Image Translation (Image)

Available in Classic and VPC

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

Request

This section describes the request format. The method and URI are as follows:

Request headers

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

Request body

You can include the following data in the body of your request:

Request example

The request example is as follows:

curl --location --request POST 'https://papago.apigw.ntruss.com/image-to-image/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;' \
--form 'source="auto"' \
--form 'target="ko"' \
--form 'image=@"{image}"'

Response

This section describes the response format.

Response body

The response body includes the following data:

blocks

The following describes blocks.

lines

The following describes lines.

words

The following describes words.

Response status codes

For information about the HTTP status codes common to all Papago Image Translation APIs, see Common Papago Image Translation response status codes.

Response example

The response example is as follows:

{
    "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
        },
        "renderedImage": "{renderedImage}",
    }
}