Rychlý start: Azure Cognitive Services Translator

Vyzkoušejte nejnovější verzi Azure Translatoru. V tomto rychlém startu začnete používat službu Translator k překladu textu pomocí programovacího jazyka podle vašeho výběru nebo rozhraní REST API. Pro tento projekt doporučujeme používat bezplatnou cenovou úroveň (F0), zatímco se seznamujete s technologií a později upgradujete na placenou úroveň pro produkční prostředí.

Požadavky

Abyste mohli začít, budete potřebovat aktivní předplatné Azure. Pokud nemáte předplatné Azure, můžete si ho zdarma vytvořit.

  • Jakmile budete mít předplatné Azure, vytvořte v Azure Portal prostředek služby Translator.

  • Po nasazení prostředku vyberte Přejít k prostředku a načtěte klíč a koncový bod.

    • K připojení aplikace ke službě Translator potřebujete klíč a koncový bod z prostředku. Klíč a koncový bod vložíte do kódu později v tomto rychlém startu. Tyto hodnoty najdete na stránce Azure Portal Klíče a koncový bod:

      Snímek obrazovky: Azure Portal klíče a stránku koncového bodu

      Poznámka

      • Pro účely tohoto rychlého startu se doporučuje použít globální prostředek služby Translator Text.
      • U globálního prostředku s jednou službou zahrnete do požadavku rozhraní REST API jednu autorizační hlavičku (Ocp-Apim-Subscription-key). Hodnota Ocp-Apim-Subscription-key je tajný klíč Azure pro vaše předplatné služby Translator Text.
      • Pokud se rozhodnete použít prostředek Cognitive Services s více službami nebo místní službu Translator, budou se vyžadovat dvě hlavičky ověřování: (Ocp-Api-Subscription-Key a Ocp-Apim-Subscription-Region). Hodnota Ocp-Apim-Subscription-Region je oblast přidružená k vašemu předplatnému.
      • Další informace o použití hlavičky Ocp-Apim-Subscription-Regionnajdete v tématuHlavičky rozhraní REST API služby Text Translator.

Hlavičky

Pokud chcete volat službu Translator prostřednictvím rozhraní REST API, musíte ke každému požadavku zahrnout následující hlavičky. Nemějte obavy, hlavičky pro vás zahrneme do ukázkového kódu pro každý programovací jazyk.

Další informace o možnostech ověřování služby Translator najdete v referenční příručce služby Translator v3 .

Hlavička Hodnota Podmínka
Ocp-Apim-Subscription-Key Klíč služby Translator z Azure Portal. Povinné
Ocp-Apim-Subscription-Region Oblast, ve které byl prostředek vytvořen. Vyžaduje se při použití služeb Cognitive Services s více službami nebo regionálního (ne globálního) prostředku.
Volitelné při použití globálního prostředku Translator s jednou službou.
Typ obsahu Typ obsahu datové části. Přijatá hodnota je application/json nebo charset=UTF-8. Povinné
Délka obsahu Délka textu požadavku. Volitelné

Důležité

Až budete hotovi, nezapomeňte klíč z kódu odebrat a nikdy ho nezveřejníte. V produkčním prostředí použijte zabezpečený způsob ukládání a přístupu k přihlašovacím údajům, jako je Azure Key Vault. Další informace najdete v článku o zabezpečení služeb Cognitive Services.

Přeložení textu

Základní operací služby Translator je překlad textu. V tomto rychlém startu vytvoříte požadavek pomocí programovacího jazyka podle vašeho výběru, který přijímá jeden zdroj (from) a poskytuje dva výstupy (to). Pak zkontrolujeme některé parametry, které je možné použít k úpravě požadavku i odpovědi.

Nastavení projektu sady Visual Studio

  1. Ujistěte se, že máte aktuální verzi integrovaného vývojového prostředí sady Visual Studio.

    Tip

    Pokud se sadou Visual Studio začínáte, vyzkoušejte modul Learn Úvod do sady Visual Studio .

  2. Otevřete sadu Visual Studio.

  3. Na úvodní stránce zvolte Vytvořit nový projekt.

    Snímek obrazovky: Úvodní okno sady Visual Studio

  4. Na stránce Create a new project (Vytvořit nový projekt) zadejte do vyhledávacího pole console (konzola ). Zvolte šablonu Konzolová aplikace a pak zvolte Další.

    Snímek obrazovky: Stránka pro vytvoření nového projektu v sadě Visual Studio

  5. V dialogovém okně Konfigurovat nový projekt zadejte translator_quickstart do pole Název projektu. Políčko Umístit řešení a projekt do stejného adresáře ponechte nezaškrtnuté a vyberte Další.

    Snímek obrazovky: Dialogové okno konfigurace nového projektu v sadě Visual Studio

  6. V dialogovém okně Další informace se ujistěte, že je vybraná možnost .NET 6.0 (Dlouhodobá podpora). Nechte nezaškrtnuté políčko Nepoužívat příkazy nejvyšší úrovně a vyberte Vytvořit.

    Snímek obrazovky: Dialogové okno s dalšími informacemi v sadě Visual Studio

Instalace balíčku Newtonsoft.json pomocí NuGetu

  1. Klikněte pravým tlačítkem na projekt translator_quickstart a vyberte Spravovat balíčky NuGet... .

    Snímek obrazovky s vyhledávacím polem balíčku NuGet

  2. Vyberte kartu Procházet a zadejte Newtonsoft.json.

    Snímek obrazovky s oknem instalace balíčku NuGet

  3. V pravém okně správce balíčků vyberte nainstalovat a přidejte balíček do projektu.

    Snímek obrazovky s tlačítkem pro instalaci balíčku NuGet

Sestavení aplikace v C#

Poznámka

  • Počínaje .NET 6 generují nové projekty používající console šablonu nový styl programu, který se liší od předchozích verzí.
  • Nový výstup používá nejnovější funkce jazyka C#, které zjednodušují kód, který potřebujete napsat.
  • Při použití novější verze stačí napsat text Main metody . Nemusíte zahrnovat příkazy nejvyšší úrovně, globální direktivy using ani implicitní direktivy using.
  • Další informace najdete v tématuNové šablony jazyka C# generují příkazy nejvyšší úrovně.
  1. Otevřete soubor Program.cs .

  2. Odstraňte existující kód včetně řádku Console.Writeline("Hello World!"). Zkopírujte vzorový kód a vložte ho do souboru Program.cs vaší aplikace. Nezapomeňte aktualizovat proměnnou klíče o hodnotu z instance služby Azure Portal Translator:

using System.Text;
using Newtonsoft.Json;

class Program
{
    private static readonly string key = "<your-translator-key>";
    private static readonly string endpoint = "https://api.cognitive.microsofttranslator.com";

    // location, also known as region.
    // required if you're using a multi-service or regional (not global) resource. It can be found in the Azure portal on the Keys and Endpoint page.
    private static readonly string location = "<YOUR-RESOURCE-LOCATION>";

    static async Task Main(string[] args)
    {
        // Input and output languages are defined as parameters.
        string route = "/translate?api-version=3.0&from=en&to=fr&to=zu";
        string textToTranslate = "I would really like to drive your car around the block a few times!";
        object[] body = new object[] { new { Text = textToTranslate } };
        var requestBody = JsonConvert.SerializeObject(body);

        using (var client = new HttpClient())
        using (var request = new HttpRequestMessage())
        {
            // Build the request.
            request.Method = HttpMethod.Post;
            request.RequestUri = new Uri(endpoint + route);
            request.Content = new StringContent(requestBody, Encoding.UTF8, "application/json");
            request.Headers.Add("Ocp-Apim-Subscription-Key", key);
            // location required if you're using a multi-service or regional (not global) resource.
            request.Headers.Add("Ocp-Apim-Subscription-Region", location);

            // Send the request and get response.
            HttpResponseMessage response = await client.SendAsync(request).ConfigureAwait(false);
            // Read response as a string.
            string result = await response.Content.ReadAsStringAsync();
            Console.WriteLine(result);
        }
    }
}

Spuštění aplikace v jazyce C#

Po přidání ukázky kódu do aplikace zvolte zelené tlačítko Start vedle formRecognizer_quickstart k sestavení a spuštění programu nebo stiskněte klávesu F5.

Snímek obrazovky s tlačítkem Spustit program v sadě Visual Studio

Výstup překladu:

Po úspěšném volání by se měla zobrazit následující odpověď:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "translations": [
            {
                "text": "J'aimerais vraiment conduire votre voiture autour du pâté de maisons plusieurs fois!",
                "to": "fr"
            },
            {
                "text": "Ngingathanda ngempela ukushayela imoto yakho endaweni evimbelayo izikhathi ezimbalwa!",
                "to": "zu"
            }
        ]
    }
]

Další kroky

A je to, blahopřejeme! Naučili jste se používat službu Translator k překladu textu.

Projděte si naši dokumentaci s postupy a projděte si podrobnější informace o možnostech překladatelské služby: