Poprzednie

Następne

Definiowanie tłumaczeń niestandardowych

Ukończone

Chociaż domyślny model tłumaczenia używany przez usługę Azure AI Translator jest skuteczny w przypadku tłumaczenia ogólnego, może być konieczne opracowanie rozwiązania do tłumaczenia dla firm lub branż, które mają określone słownictwo terminów, które wymagają tłumaczenia niestandardowego.

Aby rozwiązać ten problem, możesz utworzyć model niestandardowy, który mapuje własne zestawy terminów źródłowych i docelowych na potrzeby tłumaczenia. Aby utworzyć model niestandardowy, użyj portalu Custom Translator, aby:

1. Utwórz obszar roboczy połączony z zasobem usługi Azure AI Translator.
2. Utwórz projekt.
3. Przekazywanie plików danych szkoleniowych i trenowanie modelu.
4. Przetestuj model i opublikuj model.
5. Wykonaj wywołania tłumaczenia do interfejsu API.

Model niestandardowy ma przypisany unikatowy identyfikator kategorii (wyróżniony na zrzucie ekranu), który można określić w translacji wywołań do zasobu usługi Azure AI Translator przy użyciu parametru kategorii , co powoduje wykonanie tłumaczenia przez model niestandardowy zamiast modelu domyślnego.

Jak wywołać interfejs API

Aby zainicjować tłumaczenie, wyślij żądanie POST do następującego adresu URL żądania:

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

Żądanie musi zawierać kilka parametrów:

• api-version: wymagana wersja interfejsu API.
• to: język docelowy do tłumaczenia. Na przykład: to=fr dla języka francuskiego.
• category: Identyfikator kategorii.

Żądanie musi również zawierać wiele wymaganych nagłówków:

• Ocp-Apim-Subscription-Key. Nagłówek klucza klienta. Na przykład: Ocp-Apim-Subscription-Key=<your-client-key>.
• Content-Type. Typ zawartości ładunku. Wymagany format to: Content-Type: application/json; charset=UTF-8.

Treść żądania powinna zawierać tablicę zawierającą obiekt JSON z właściwością określającą Text tekst, który ma zostać przetłumaczony:

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

Istnieją różne sposoby wysyłania żądania do interfejsu API, w tym przy użyciu języków C#, Python i curl. Aby na przykład wykonać szybkie wywołanie, możesz wysłać żądanie POST przy użyciu narzędzia 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?'}]"

Powyższe żądanie wykonuje wywołanie tłumaczenia zdania z języka angielskiego na holenderski.

Zwrócona odpowiedź

Odpowiedź zwraca kod odpowiedzi, 200 jeśli żądanie zakończyło się pomyślnie. Zwraca również treść odpowiedzi zawierającą przetłumaczony tekst, w następujący sposób:

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

Jeśli żądanie nie powiodło się, może zostać zwróconych wiele różnych kodów stanu w zależności od typu błędu, takiego jak 400 (brakujące lub nieprawidłowe parametry zapytania). Zobacz Kody stanu odpowiedzi, aby uzyskać pełną listę kodów i ich wyjaśnienie.

Uwaga

Aby uzyskać więcej informacji na temat tłumaczenia niestandardowego, zobacz Szybki start: tworzenie, publikowanie i tłumaczenie za pomocą modeli niestandardowych.

Kontynuuj