Translator 3.0:Detect

  • [アーティクル]

テキストの一部の言語を識別します。

要求 URL

POST 要求の送信先は次のとおりです。

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

Translator で選択されているネットワークとプライベート エンドポイントの構成とサポートについては、「仮想ネットワークのサポート」を "参照してください"。

要求パラメーター

クエリ文字列に渡される要求パラメーターを次に示します。

Query parameter (クエリ パラメーター) 説明
api-version "必須のパラメーター"。
クライアントによって要求される API のバージョン。 値は 3.0 とする必要があります。

要求ヘッダーには次のものがあります。

ヘッダー 説明
認証ヘッダー "必須の要求ヘッダー" です。
認証に使用できるオプションに関するページをご覧ください。
Content-Type "必須の要求ヘッダー" です。
ペイロードのコンテンツ タイプを指定します。 次のいずれかの値になります。application/json
Content-Length "必須の要求ヘッダー" です。
要求本文の長さです。
X-ClientTraceId オプション。
要求を一意に識別する、クライアントで生成された GUID。 ClientTraceId という名前のクエリ パラメーターを使用してクエリ文字列内にトレース ID を含める場合、このヘッダーは省略できます。

要求本文

要求の本文は JSON 配列です。 各配列要素は、Text という名前の文字列プロパティを持つ JSON オブジェクトです。 言語の検出は、Text プロパティの値に適用されます。 言語自動検出は、入力テキストが長いほど、うまく機能します。 サンプルの要求本文は次のようになります。

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

次の制限事項が適用されます。

  • 配列に含めることができる要素は、最大でも 100 個です。
  • 要求に含めるテキスト全体は、スペースも含めて 50,000 文字以下にする必要があります。

応答本文

正常な応答は、入力配列内の文字列ごとに 1 つの結果が含まれる JSON 配列となります。 結果オブジェクトには次のプロパティが含まれています。

  • language:検出された言語のコードです。

  • score:結果内の信頼度を示す浮動小数点値です。 スコアは 0 から 1 の範囲であり、低いスコアは低い信頼度を示します。

  • isTranslationSupported: 検出された言語がテキスト翻訳でサポートされている言語の 1 つである場合に true になるブール値です。

  • isTransliterationSupported: 検出された言語が音訳でサポートされている言語の 1 つである場合に true になるブール値です。

  • alternatives:利用可能な他の言語の配列です。 配列の各要素は、次のプロパティを持つ別のオブジェクトです: language、score、isTranslationSupported、isTransliterationSupported。

JSON 応答の例を次に示します。

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

応答ヘッダー

ヘッダー 説明
X-RequestId 要求を識別するためにサービスによって生成される値。 トラブルシューティングの目的で使用されます。

応答状態コード

要求によって返される可能性のある HTTP 状態コードを次に示します。

状態コード 説明
200 正常終了しました。
400 クエリ パラメーターの 1 つが欠落しているか無効です。 再試行する前に要求パラメーターを修正してください。
401 要求を認証できませんでした。 資格情報が指定され、有効であることを確認してください。
403 要求は承認されません。 詳細なエラー メッセージを確認してください。 このコードは、多くの場合、試用版サブスクリプションで提供されるすべての無料翻訳が使い果たされたことを示します。
429 クライアントが要求の制限を超えたため、サーバーは要求を拒否しました。
500 予期しないエラーが発生しました。 エラーが解決しない場合は、エラー発生の日時、応答ヘッダー X-RequestId からの要求識別子、要求ヘッダー X-ClientTraceId からのクライアント識別子を添えてその旨をご報告ください。
503 サーバーが一時的に使用できません。 要求をやり直してください。 エラーが解決しない場合は、エラー発生の日時、応答ヘッダー X-RequestId からの要求識別子、要求ヘッダー X-ClientTraceId からのクライアント識別子を添えてその旨をご報告ください。

エラーが発生した場合、要求から JSON エラー応答を返します。 このエラーコードは 3 桁の HTTP ステータス コードの後に､エラーをさらに分類するための 3 桁の数字を続けた 6 桁の数字です｡ 一般的なエラー コードは、v3 Translator のリファレンス ページで確認できます。

例

次の例では、テキスト翻訳でサポートされている言語を取得する方法を示します。

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"