Definování vlastních překladů

  • 5 min

I když je výchozí model překladu používaný službou Azure AI Translator efektivní pro obecný překlad, možná budete muset vyvíjet řešení překladu pro firmy nebo odvětví v určitých slovních zásobách, které vyžadují vlastní překlad.

Pokud chcete tento problém vyřešit, můžete vytvořit vlastní model, který mapuje vlastní sady zdrojových a cílových termínů pro překlad. Pokud chcete vytvořit vlastní model, použijte portál Custom Translator k následujícímu:

  1. Vytvořte pracovní prostor propojený s prostředkem Azure AI Translator.
  2. Vytvořte projekt.
  3. Nahrajte trénovací datové soubory a vytrénujte model.
  4. Otestujte model a publikujte model.
  5. Volání překladu do rozhraní API

Screenshot showing the Custom Translator portal.

Vlastní model má přiřazené jedinečné ID kategorie (zvýrazněné na snímku obrazovky), které můžete zadat při překladu volání prostředku Azure AI Translator pomocí parametru kategorie , což způsobí, že místo výchozího modelu bude překlad proveden vaším vlastním modelem.

Postup při volání rozhraní API

Pokud chcete zahájit překlad, odešlete požadavek POST na následující adresu URL požadavku:

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

Váš požadavek musí obsahovat několik parametrů:

  • api-version: Požadovaná verze rozhraní API.
  • to: Cílový jazyk, na který se má přeložit. Příklad: to=fr pro francouzštinu.
  • category: ID vaší kategorie.

Váš požadavek musí obsahovat také řadu požadovaných hlaviček:

  • Ocp-Apim-Subscription-Key. Hlavička klientského klíče Například: Ocp-Apim-Subscription-Key=<your-client-key>.
  • Content-Type. Typ obsahu datové části. Požadovaný formát je: Content-Type: application/json; charset=UTF-8.

Text požadavku by měl obsahovat pole obsahující objekt JSON s Text vlastností, která určuje text, který chcete přeložit:

[
    {"Text":"Where can I find my employee details?"}
]

Existují různé způsoby, jak odeslat požadavek do rozhraní API, včetně použití C#, Pythonu a curlu. Například k rychlému volání můžete odeslat požadavek POST pomocí nástroje curl:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

Výše uvedený požadavek volá větu z angličtiny do holandštiny.

Vrácená odpověď

Odpověď vrátí kód odpovědi, pokud 200 byl požadavek úspěšný. Vrátí také text odpovědi, který obsahuje přeložený text, například takto:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

Pokud požadavek nebyl úspěšný, může se vrátit několik různých stavových kódů v závislosti na typu chyby, například 400 (chybějící nebo neplatné parametry dotazu). Úplný seznam kódů a jejich vysvětlení najdete v části Stavové kódy odpovědi.

Poznámka:

Další informace o vlastním překladu najdete v tématu Rychlý start: Sestavení, publikování a překlad s vlastními modely.