Freigeben über

Azure Translator in Foundry Tools 3.0: Erkennen

Identifiziert die Sprache eines Textabschnitts.

Anfrage-URL

Senden Sie eine POST Anforderung an:

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

SieheVirtual Network Support for Translator selected network and private endpoint configuration and support.see Virtual Network Support for Translator selected network and private endpoint configuration and support.

Anforderungsparameter

Anforderungsparameter, die an die Abfragezeichenfolge übergeben werden, sind:

Query parameter (Abfrageparameter) Description
API-Version Erforderlicher Parameter.
Version der API, die vom Client angefordert wird. Der Wert muss 3.0 sein.

Anforderungsheader umfassen:

Headers Description
Authentifizierungsheader Erforderlicher Anforderungsheader.
Weitere Informationen finden Sie unter den verfügbaren Optionen für die Authentifizierung.
Inhaltstyp Erforderlicher Anforderungsheader.
Gibt den Inhaltstyp der Nutzlast an. Mögliche Werte sind: application/json.
Inhaltslänge Optional
Die Länge des Anforderungstexts.
X-ClientTraceId Optional
Eine vom Client generierte GUID, um die Anforderung eindeutig zu identifizieren. Sie können diesen Header weglassen, wenn Sie die Ablaufverfolgungs-ID in die Abfragezeichenfolge mithilfe eines Abfrageparameters mit dem Namen ClientTraceIdeinschließen.

Anfragekörper

Der Textkörper der Anforderung ist ein JSON-Array. Jedes Arrayelement ist ein JSON-Objekt mit einer Zeichenfolgeneigenschaft namens Text. Die Spracherkennung wird auf den Wert der Text Eigenschaft angewendet. Die automatische Spracherkennung funktioniert besser mit längerem Eingabetext. Ein Beispielanforderungstext sieht wie folgt aus:

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

Es gelten die folgenden Einschränkungen:

  • Das Array kann höchstens 100 Elemente aufweisen.
  • Der gesamte text, der in der Anforderung enthalten ist, darf 50.000 Zeichen einschließlich Leerzeichen nicht überschreiten.

Antworttext

Eine erfolgreiche Antwort ist ein JSON-Array mit einem Ergebnis für jede Zeichenfolge im Eingabearray. Ein Ergebnisobjekt enthält die folgenden Eigenschaften:

  • language: Code der erkannten Sprache.

  • score: Ein Float-Wert, der die Konfidenz des Ergebnisses angibt. Die Bewertung liegt zwischen Null und 1 und einem niedrigen Wert, was eine niedrige Konfidenz angibt.

  • isTranslationSupported: Ein boolescher Wert, der zutrifft, wenn die erkannte Sprache eine der sprachen ist, die für die Textübersetzung unterstützt werden.

  • isTransliterationSupported: Ein boolescher Wert, der zutrifft, wenn die erkannte Sprache eine der sprachen ist, die für die Transliteration unterstützt werden.

  • alternatives: Ein Array anderer möglicher Sprachen. Jedes Element des Arrays ist ein weiteres Objekt mit den folgenden Eigenschaften: language, , score, isTranslationSupportedund isTransliterationSupported.

Beispiel für eine JSON-Antwort:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Antwortkopfzeilen

Headers Description
X-RequestId Vom Dienst generierter Wert, um die Anforderung zu identifizieren und für Problembehandlungszwecke verwendet zu werden.

Statuscodes für Antworten

Nachfolgend sind die möglichen HTTP-Statuscodes aufgeführt, die von einer Anforderung zurückgegeben werden.

Statuscode Description
200 Erfolg.
400 Einer der Abfrageparameter fehlt oder ist ungültig. Korrigieren Sie die Anforderungsparameter, bevor Sie den Vorgang wiederholen.
401 Die Anforderung konnte nicht authentifiziert werden. Überprüfen Sie, ob Anmeldeinformationen angegeben und gültig sind.
403 Die Anforderung ist nicht autorisiert. Überprüfen Sie die Fehlermeldung "Details". Dieser Code gibt häufig an, dass alle kostenlosen Übersetzungen, die mit einem Testabonnement bereitgestellt werden, verwendet werden.
429 Der Server hat die Anforderung abgelehnt, da der Client die Anforderungsgrenzwerte überschritten hat.
500 Ein unerwarteter Fehler ist aufgetreten. Wenn der Fehler weiterhin besteht, melden Sie ihn mit: Datum und Uhrzeit des Fehlers, Anforderungsbezeichner vom Antwortheader und Client-ID aus Anforderungsheader X-RequestIdX-ClientTraceId.
503 Der Server ist vorübergehend nicht verfügbar. Wiederholen Sie die Anforderung. Wenn der Fehler weiterhin besteht, melden Sie ihn mit: Datum und Uhrzeit des Fehlers, Anforderungsbezeichner vom Antwortheader und Client-ID aus Anforderungsheader X-RequestIdX-ClientTraceId.

Wenn ein Fehler auftritt, gibt die Anforderung eine JSON-Fehlerantwort zurück. Der Fehlercode ist eine 6-stellige Zahl, die den 3-stelligen HTTP-Statuscode kombiniert, gefolgt von einer 3-stelligen Zahl, um den Fehler weiter zu kategorisieren. Allgemeine Fehlercodes finden Sie auf der v3 Translator-Referenzseite.

Examples

Das folgende Beispiel zeigt, wie Sprachen abgerufen werden, die für die Textübersetzung unterstützt werden.

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?'}]"
  • Last updated on