Translator 3.0: Detect

Artikel
09/01/2024

Identifiziert die Sprache eines Textabschnitts.

Anfrage-URL

Sendet eine POST-Anforderung an:

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

Weitere Informationen finden Sie unter "Virtual Network Support for Translator service selected network and private endpoint configuration and support".

Anforderungsparameter

Die folgenden Anforderungsparameter werden in der Abfragezeichenfolge übergeben:

Query parameter (Abfrageparameter)	BESCHREIBUNG
api-version	Erforderlicher Parameter. Die vom Client angeforderte Version der API. Der Wert muss `3.0` sein.

Anforderungsheader enthalten Folgendes:

Header	Beschreibung
Authentifizierungsheader	Erforderlicher Anforderungsheader. Weitere Informationen finden Sie in den verfügbaren Optionen für die Authentifizierung.
Content-Type	Erforderlicher Anforderungsheader. Gibt den Inhaltstyp der Nutzlast an. Mögliche Werte: `application/json`.
Content-Length	Optional. Die Länge des Anforderungstexts.
X-ClientTraceId	Optional: Eine vom Client erstellte GUID zur eindeutigen Identifizierung der Anforderung. Sie können diesen Header nur weglassen, wenn Sie die Ablaufverfolgungs-ID in die Abfragezeichenfolge über einen Abfrageparameter namens `ClientTraceId` einschließen.

Anforderungstext

Der Anforderungstext 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. Ein längerer Eingabetext erhöht die Zuverlässigkeit der automatischen Spracherkennung. Ein Beispiel-Anforderungstext sieht folgendermaßen 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 über 100 Elemente verfügen.
Der gesamte Anforderungstext darf nicht mehr als 50.000 Zeichen enthalten (einschließlich Leerzeichen).

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 Zuverlässigkeit des Ergebnisses angibt. Die Bewertung bewegt sich zwischen 0 (null) und 1, und eine niedrige Bewertung gibt an, dass die Zuverlässigkeit zweifelhaft ist.
isTranslationSupported: Ein boolescher Wert, der TRUE lautet, wenn die erkannte Sprache eine der für die Textübersetzung unterstützten Sprachen ist
isTransliterationSupported: Ein boolescher Wert, der TRUE lautet, wenn die erkannte Sprache eine der für die Transliteration unterstützten Sprachen ist.
alternatives: Ein Array anderer möglicher Sprachen. Jedes Element des Arrays ist ein weiteres Objekt mit den folgenden Eigenschaften: language, , score, isTranslationSupportedund isTransliterationSupported.

Eine JSON-Beispielantwort lautet wie folgt:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Antwortheader

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

Antwortstatuscodes

Im Folgenden finden Sie die möglichen HTTP-Statuscodes, die eine Anforderung zurückgeben kann.

Statuscode	BESCHREIBUNG
200	Erfolg.
400	Einer der Abfrageparameter fehlt oder ist ungültig. Korrigieren Sie die Anforderungsparameter, bevor Sie es erneut versuchen.
401	Die Anforderung konnte nicht authentifiziert werden. Überprüfen Sie, ob die Anmeldeinformationen angegeben und gültig sind.
403	Die Anforderung ist nicht autorisiert. Weitere Informationen finden Sie in der Fehlermeldung. 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, und gebe Sie Folgendes an: Datum und Zeitpunkt des Fehlers, Anforderungsbezeichner aus dem Anforderungsheader `X-RequestId` und Clientbezeichner aus dem Anforderungsheader `X-ClientTraceId`.
503	Der Server ist vorübergehend nicht verfügbar. Wiederholen Sie die Anforderung. Wenn der Fehler weiterhin besteht, melden Sie ihn, und gebe Sie Folgendes an: Datum und Zeitpunkt des Fehlers, Anforderungsbezeichner aus dem Anforderungsheader `X-RequestId` und Clientbezeichner aus dem Anforderungsheader `X-ClientTraceId`.

Sollte ein Fehler auftreten, gibt die Anforderung eine JSON-Fehlerantwort zurück. Der Fehlercode ist eine 6-stellige Zahl, die aus dem 3-stelligen HTTP-Statuscode gefolgt von einer 3-stelligen Zahl zur Kategorisierung des Fehlers besteht. Häufige Fehlercodes finden Sie in der Referenz zu Version 3 von Translator.

Beispiele

Im folgenden Beispiel wird dargestellt, 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?'}]"

Freigeben über