Translator 3.0: Identifiera

Artikel
09/01/2024

Identifierar språket i ett textstycke.

Begärans-URL

Skicka en POST-begäran till:

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

Se Stöd för virtuellt nätverk för Translator-tjänsten valt nätverk och privat slutpunktskonfiguration och support.

Parametrar för begäran

Begärandeparametrar som skickas på frågesträngen är:

Frågeparameter	beskrivning
api-version	Obligatorisk parameter. Version av API:et som begärs av klienten. Värdet måste vara `3.0`.

Bland begäranderubrikerna finns:

Sidhuvuden	beskrivning
Autentiseringshuvuden	Obligatoriskt begärandehuvud. Se tillgängliga alternativ för autentisering.
Innehållstyp	Obligatoriskt begärandehuvud. Anger nyttolastens innehållstyp. Möjliga värden är: `application/json`.
Innehållslängd	Valfritt. Längden på begärandetexten.
X-ClientTraceId	Valfritt. Ett klientgenererat GUID för att unikt identifiera begäran. Du kan utelämna den här rubriken om du inkluderar spårnings-ID:t i frågesträngen med hjälp av en frågeparameter med namnet `ClientTraceId`.

Begärandetext

Brödtexten i begäran är en JSON-matris. Varje matriselement är ett JSON-objekt med en strängegenskap med namnet Text. Språkidentifiering tillämpas på värdet för Text egenskapen. Autodetection för språk fungerar bättre med längre indatatext. Ett exempel på begärandetext ser ut så här:

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

Följande begränsningar gäller:

Matrisen kan ha högst 100 element.
Hela texten som ingår i begäran får inte överstiga 50 000 tecken, inklusive blanksteg.

Själva svaret

Ett lyckat svar är en JSON-matris med ett resultat för varje sträng i indatamatrisen. Ett resultatobjekt innehåller följande egenskaper:

language: Kod för det identifierade språket.
score: Ett flyttalsvärde som anger konfidensen i resultatet. Poängen är mellan noll och en och en låg poäng indikerar ett lågt förtroende.
isTranslationSupported: Ett booleskt värde som är sant om det identifierade språket är ett av de språk som stöds för textöversättning.
isTransliterationSupported: Ett booleskt värde som är sant om det identifierade språket är ett av de språk som stöds för transkribering.
alternatives: En matris med andra möjliga språk. Varje element i matrisen är ett annat objekt med följande egenskaper: language, score, isTranslationSupportedoch isTransliterationSupported.

Ett exempel på JSON-svar är:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Svarsrubriker

Sidhuvuden	beskrivning
X-RequestId	Värde som genereras av tjänsten för att identifiera begäran och som används för felsökning.

Svarsstatuskoder

Följande är de möjliga HTTP-statuskoder som en begäran returnerar.

Statuskod	beskrivning
200	Klart!
400	En av frågeparametrarna saknas eller är ogiltig. Korrigera parametrar för begäran innan du försöker igen.
401	Det gick inte att autentisera begäran. Kontrollera att autentiseringsuppgifterna är angivna och giltiga.
403	Begäran är inte auktoriserad. Kontrollera informationsfelmeddelandet. Den här koden anger ofta att alla kostnadsfria översättningar som tillhandahålls med en utvärderingsprenumeration används.
429	Servern avvisade begäran eftersom klienten överskred begärandegränserna.
500	Ett oväntat fel har uppstått. Om felet kvarstår rapporterar du det med: datum och tid för felet, begärandeidentifierare från svarshuvudet `X-RequestId`och klientidentifierare från begärandehuvudet `X-ClientTraceId`.
503	Servern är inte tillgänglig för tillfället. Försök igen med begäran. Om felet kvarstår rapporterar du det med: datum och tid för felet, begärandeidentifierare från svarshuvudet `X-RequestId`och klientidentifierare från begärandehuvudet `X-ClientTraceId`.

Om ett fel inträffar returnerar begäran ett JSON-felsvar. Felkoden är ett 6-siffrigt tal som kombinerar den tresiffriga HTTP-statuskoden följt av ett tresiffrigt tal för att ytterligare kategorisera felet. Vanliga felkoder finns på referenssidan för Translator v3.

Exempel

I följande exempel visas hur du hämtar språk som stöds för textöversättning.

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?'}]"

Dela via