Image Translation(Text)
- 印刷する
- PDF
Image Translation(Text)
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Classic/VPC環境で利用できます。
入力された JPG、JPEG、PNG、TIFF形式の画像内テキストを認識(OCR)して翻訳テキストを提供します。
参考
API使用前に次の内容をご確認ください。
- 画像のサイズが小さすぎると、翻訳結果の品質が低下する場合があります。長軸基準で1,280px以上の画像を使用することをお勧めします。
- 歪曲された画像、筆記体文字、小さいサイズの文字、背景色や文字色が類似した画像を使用すると翻訳品質に影響を与えることができます。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
POST | /v1/translate |
リクエストヘッダ
Papago Image Translation APIで共通して使用されるヘッダの詳細は、Papago Image Translationの共通ヘッダをご参照ください。
リクエストボディ
リクエストボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
source | String | Required | 原本テキスト(Source)の言語コード
|
target | String | Required | 翻訳結果テキスト(Target)の言語コード
|
image | JPG, JPEG, PNG, TIFF | Required | ソース画像ファイル |
参考
ソース言語を指定しなくても(auto
に指定)自動で言語を検出して翻訳結果を提供します。この場合、言語の検出に追加の課金は行わず、翻訳リクエストの文字数の基準でのみ課金します。
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request POST 'https://naveropenapi.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 | - | ブロック単位テキスト認識の詳細情報 |
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
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
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の共通レスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"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
}
}
この記事は役に立ちましたか?