Translator 3.0: Detekce

Článek
09/01/2024

Identifikuje jazyk části textu.

Adresa URL požadavku

Odešlete požadavek POST do:

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

Viz Podpora virtuální sítě pro vybranou službu Translator a konfiguraci a podporu privátního koncového bodu.

Parametry požadavku

Parametry požadavku předané v řetězci dotazu jsou:

Parametr dotazu	Popis
verze-api	Povinný parametr. Verze rozhraní API požadovaného klientem Hodnota musí být `3.0`.

Hlavičky požadavku zahrnují:

Hlavičky	Popis
Hlavičky ověřování	Požadovaná hlavička požadavku. Podívejte se na dostupné možnosti ověřování.
Typ obsahu	Požadovaná hlavička požadavku. Určuje typ obsahu datové části. Možné hodnoty jsou: `application/json`.
Délka obsahu	Volitelné. Délka textu požadavku.
X-ClientTraceId	Volitelné. Identifikátor GUID vygenerovaný klientem pro jedinečnou identifikaci požadavku. Tuto hlavičku můžete vynechat, pokud do řetězce dotazu zahrnete ID trasování pomocí parametru dotazu s názvem `ClientTraceId`.

Text požadavku

Text požadavku je pole JSON. Každý prvek pole je objekt JSON s řetězcovou vlastností s názvem Text. Rozpoznávání jazyka se použije na hodnotu Text vlastnosti. Automatické rozpoznávání jazyka funguje lépe s delším vstupním textem. Ukázkový text požadavku vypadá takto:

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

Platí následující omezení:

Pole může mít maximálně 100 prvků.
Celý text obsažený v požadavku nesmí překročit 50 000 znaků včetně mezer.

Text odpovědi

Úspěšná odpověď je pole JSON s jedním výsledkem pro každý řetězec ve vstupním poli. Výsledný objekt obsahuje následující vlastnosti:

language: Kód zjištěného jazyka.
score: Hodnota float označující spolehlivost ve výsledku. Skóre je mezi nulou a jedním a nízkým skóre označuje nízkou spolehlivost.
isTranslationSupported: Logická hodnota, která je true, pokud zjištěný jazyk je jedním z jazyků podporovaných pro překlad textu.
isTransliterationSupported: Logická hodnota, která je true, pokud zjištěný jazyk je jedním z jazyků podporovaných pro transkliteraci.
alternatives: Pole dalších možných jazyků. Každý prvek pole je dalším objektem následující vlastnosti: language, score, isTranslationSupported, a isTransliterationSupported.

Příkladem odpovědi JSON je:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Hlavičky odpovědi

Hlavičky	Popis
X-RequestId	Hodnota vygenerovaná službou k identifikaci požadavku a použití pro účely řešení potíží.

Stavové kódy odpovědí

Níže jsou uvedené možné stavové kódy HTTP, které požadavek vrátí.

Kód stavu	Popis
200	Akce byla úspěšná.
400	Jeden z parametrů dotazu chybí nebo je neplatný. Před opakováním opravte parametry požadavku.
401	Požadavek nelze ověřit. Zkontrolujte, jestli jsou zadané a platné přihlašovací údaje.
403	Požadavek není autorizovaný. Zkontrolujte chybovou zprávu s podrobnostmi. Tento kód často označuje, že se používají všechny bezplatné překlady poskytnuté se zkušebním předplatným.
429	Server odmítl požadavek, protože klient překročil limity požadavků.
500	Došlo k neočekávané chybě. Pokud chyba přetrvává, nahlašte ji s: datem a časem selhání, identifikátorem požadavku z hlavičky `X-RequestId`odpovědi a identifikátorem klienta z hlavičky `X-ClientTraceId`požadavku .
503	Server je dočasně nedostupný. Zkuste požadavek zopakovat. Pokud chyba přetrvává, nahlašte ji s: datem a časem selhání, identifikátorem požadavku z hlavičky `X-RequestId`odpovědi a identifikátorem klienta z hlavičky `X-ClientTraceId`požadavku .

Pokud dojde k chybě, požadavek vrátí chybovou odpověď JSON. Kód chyby je 6místné číslo, které kombinuje 3místný stavový kód HTTP následovaný 3místným číslem, aby se chyba dále kategorizovala. Běžné kódy chyb najdete na referenční stránce služby Translator v3.

Příklady

Následující příklad ukazuje, jak načíst jazyky podporované pro překlad textu.

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

Sdílet prostřednictvím