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.