Tworzenie zasobu usługi Translator

Z tego artykułu dowiesz się, jak utworzyć zasób usługi Translator w witrynie Azure Portal. Azure AI Translator to oparta na chmurze usługa tłumaczenia maszynowego, która jest częścią rodziny usług Azure AI. Zasoby platformy Azure to wystąpienia tworzonych usług. Wszystkie żądania interfejsu API do usług azure AI wymagają adresu URL punktu końcowego i klucza tylko do odczytu na potrzeby uwierzytelniania dostępu.

Wymagania wstępne

Do rozpoczęcia pracy potrzebne jest aktywne konto platformy Azure. Jeśli go nie masz, możesz utworzyć bezpłatną 12-miesięczną subskrypcję.

Tworzenie zasobu

Za pomocą konta platformy Azure możesz uzyskać dostęp do usługi Translator za pomocą dwóch różnych typów zasobów:

• Typy zasobów pojedynczej usługi umożliwiają dostęp do pojedynczego klucza i punktu końcowego interfejsu API usługi.

• Typy zasobów z wieloma usługami umożliwiają dostęp do wielu usług Azure AI przy użyciu jednego klucza interfejsu API i punktu końcowego.

Uzupełnianie szczegółów projektu i wystąpienia

Po podjęciu decyzji o typie zasobu, którego chcesz użyć do uzyskania dostępu do usługi Translator, możesz wprowadzić szczegóły projektu i wystąpienia.

1. Subskrypcja. Wybierz jedną z dostępnych subskrypcji platformy Azure.

2. Grupa zasobów. Możesz utworzyć nową grupę zasobów lub dodać zasób do istniejącej grupy zasobów, która współużytkuje ten sam cykl życia, uprawnienia i zasady.

3. Region zasobów. Wybierz pozycję Globalny , chyba że Twoja firma lub aplikacja wymaga określonego regionu. Jeśli planujesz korzystanie z funkcji tłumaczenia dokumentów z autoryzacją tożsamości zarządzanej, wybierz region geograficzny, taki jak Wschodnie stany USA.

4. Name. Wprowadź nazwę zasobu. Wybrana nazwa musi być unikatowa na platformie Azure.

   Uwaga

   Jeśli używasz funkcji translatora, która wymaga niestandardowego punktu końcowego domeny, takiego jak tłumaczenie dokumentów, dane wejściowe w name polu jest parametrem niestandardowej nazwy domeny dla punktu końcowego.

Upewnij się, że w polu wprowadź poprawną wartość, name aby zapewnić odpowiednią funkcjonalność.

1. Warstwa cenowa. Wybierz warstwę cenową spełniającą Twoje potrzeby:

   • Każda subskrypcja ma warstwę Bezpłatna.
   • Warstwa Bezpłatna ma te same funkcje i funkcje co płatne plany i nie wygasa.
   • Na subskrypcję jest dostępny tylko jeden zasób w warstwie Bezpłatna.
   • Tłumaczenie dokumentów jest obsługiwane w warstwach płatnych. Program Language Studio obsługuje tylko warstwy wystąpień S1 lub D3. Jeśli chcesz wypróbować tłumaczenie dokumentów, wybierz warstwę wystąpienia Standardowa S1.

2. Jeśli utworzono zasób z wieloma usługami, linki w dolnej części karty Podstawy zawierają dokumentację techniczną dotyczącą odpowiedniej operacji usługi.

3. Wybierz pozycję Przejrzyj i utwórz.

4. Przejrzyj warunki usługi i wybierz pozycję Utwórz , aby wdrożyć zasób.

5. Po pomyślnym wdrożeniu zasobu wybierz pozycję Przejdź do zasobu.

Klucze uwierzytelniania i adres URL punktu końcowego

Wszystkie żądania interfejsu API usługi Azure AI wymagają adresu URL punktu końcowego i klucza tylko do odczytu na potrzeby uwierzytelniania.

• Klucze uwierzytelniania. Klucz jest unikatowym ciągiem przekazywanym na każde żądanie do usługi tłumaczenia. Klucz można przekazać za pomocą parametru ciągu zapytania lub określając go w nagłówku żądania HTTP.

• Adres URL punktu końcowego. Użyj globalnego punktu końcowego w żądaniu interfejsu API, chyba że potrzebujesz określonego regionu platformy Azure lub niestandardowego punktu końcowego. Aby uzyskać więcej informacji, zobacz Podstawowe adresy URL. Adres URL globalnego punktu końcowego to api.cognitive.microsofttranslator.com.

Uzyskiwanie kluczy uwierzytelniania i punktu końcowego

Aby uwierzytelnić połączenie z zasobem usługi Translator, potrzebny jest klucz i punkt końcowy zasobu.

1. Po wdrożeniu nowego zasobu wybierz pozycję Przejdź do zasobu lub przejdź do strony zasobu.
2. W okienku nawigacji po lewej stronie w obszarze Zarządzanie zasobami wybierz pozycję Klucze i punkt końcowy.
3. Skopiuj i wklej klucze i adres URL punktu końcowego w dogodnej lokalizacji, takiej jak Notatnik.

Tworzenie klienta tłumaczenia tekstu

Tłumaczenie tekstu obsługuje punkty końcowe globalne i regionalne. Po utworzeniu kluczy uwierzytelniania należy utworzyć wystąpienie TextTranslationClientobiektu , używając AzureKeyCredential elementu do uwierzytelniania, aby wchodzić w interakcję z usługą tłumaczenia tekstu:

• Aby utworzyć TextTranslationClient za pomocą globalnego punktu końcowego zasobu, potrzebny jest klucz interfejsu API zasobu:

    AzureKeyCredential credential = new('<apiKey>');
    TextTranslationClient client = new(credential);
  

• Aby utworzyć TextTranslationClient za pomocą regionalnego punktu końcowego zasobu, potrzebny jest klucz interfejsu API zasobu i nazwa regionu, w którym znajduje się zasób:

   AzureKeyCredential credential = new('<apiKey>');
   TextTranslationClient client = new(credential, '<region>');
  

Jak usunąć zasób lub grupę zasobów

Ostrzeżenie

Usunięcie grupy zasobów powoduje również usunięcie wszystkich zasobów zawartych w grupie.

Aby usunąć zasób:

1. Wyszukaj i wybierz pozycję Grupy zasobów w witrynie Azure Portal, a następnie wybierz grupę zasobów.
2. Zaznacz zasoby, które mają zostać usunięte, zaznaczając sąsiadujące pole wyboru.
3. Wybierz pozycję Usuń z górnego menu w pobliżu prawej krawędzi.
4. Wprowadź polecenie usuń w oknie dialogowym Usuwanie zasobów .
5. Wybierz Usuń.

Aby usunąć grupę zasobów:

1. Przejdź do grupy zasobów w witrynie Azure Portal.
2. Wybierz pozycję Usuń grupę zasobów na górnym pasku menu.
3. Potwierdź żądanie usunięcia, wprowadzając nazwę grupy zasobów i wybierając pozycję Usuń.

Jak rozpocząć pracę z interfejsami API REST usługi Azure AI Translator

Z naszego przewodnika Szybki start dowiesz się, jak używać usługi Translator z interfejsami API REST.

Wprowadzenie do usługi Translator

Następne kroki

Dowiedz się więcej o funkcjach usługi Azure AI Translator:

• Tłumaczenie tekstu
• Tłumaczenie dokumentu
• Tłumaczenie niestandardowe