Rychlý start: Rozhraní REST API služby Azure AI Translator

Vyzkoušejte nejnovější verzi služby Azure AI Translator. V tomto rychlém startu začněte 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žít cenovou úroveň Free (F0), zatímco se učíte technologii a později upgradujete na placenou úroveň pro produkční prostředí.

Požadavky

Potřebujete aktivní předplatné Azure. Pokud předplatné Azure nemáte, můžete si ho zdarma vytvořit.

  • Jakmile budete mít předplatné Azure, vytvořte prostředek Translatoru na webu Azure Portal.

  • Po nasazení prostředku vyberte Přejít k prostředku a načtěte svůj 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 rychlém startu. Tyto hodnoty najdete na stránce Klíče webu Azure Portal a koncový bod :

      Screenshot: Azure portal keys and endpoint page.

      Poznámka:

      • Pro účely tohoto rychlého startu se doporučuje použít globální prostředek služby Translator text s jednou službou.
      • S globálním prostředkem s jednou službou zahrnete jednu autorizační hlavičku (Ocp-Apim-Subscription-key) s požadavkem rozhraní REST API. Hodnota pro Ocp-Apim-Subscription-key je tajný klíč Azure pro vaše předplatné Translator Text.
      • Pokud se rozhodnete použít prostředek Azure AI pro více služeb 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 pro 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-Region najdete v tématuHlavičky rozhraní REST API pro překlad textu.

Hlavičky

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

Další informace o možnostech ověřování translatoru 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 webu Azure Portal. Povinné
Ocp-Apim-Subscription-Region Oblast, ve které byl prostředek vytvořen. Vyžaduje se při použití víceslužbového nebo regionálního (geografického) prostředku Azure AI, jako je USA – západ.
Volitelné při použití globálního prostředku služby 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é

Nezapomeňte klíč z kódu odebrat, až to budete hotovi, a nikdy ho veřejně neposílejte. V produkčním prostředí použijte bezpečný způsob ukládání přihlašovacích údajů a přístupu k vašim přihlašovacím údajům, jako je Azure Key Vault. Další informace najdete v článku zabezpečení služeb Azure AI.

Přeložení textu

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

Podrobné informace o omezeních požadavků služby Azure AI Translator najdete v tématuOmezení požadavků na překlad textu.

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 s sadou Visual Studio začínáte, vyzkoušejte modul Úvod do sady Visual Studio Learn.

  2. Otevřete sadu Visual Studio.

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

    Screenshot: Visual Studio start window.

  4. Na stránce Vytvořit nový projekt zadejte konzolu do vyhledávacího pole. Zvolte šablonu konzolové aplikace a pak zvolte Další.

    Screenshot: Visual Studio's create new project page.

  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 zaškrtněte políčko Další.

    Screenshot: Visual Studio's configure new project dialog window.

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

    Screenshot: Visual Studio's additional information dialog window.

Instalace balíčku Newtonsoft.json pomocí NuGetu

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

    Screenshot of the NuGet package search box.

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

    Screenshot of the NuGet package install window.

  3. Chcete-li přidat balíček do projektu, vyberte nainstalovat z pravého okna správce balíčků.

    Screenshot of the NuGet package install button.

Sestavení aplikace v jazyce C#

Poznámka:

  • Od .NET 6 vygenerují nové projekty používající console šablonu nový styl programu, který se liší od předchozích verzí.
  • Nový výstup používá nedávné funkce jazyka C#, které zjednodušují psaní kódu.
  • Pokud používáte novější verzi, stačí napsat pouze tělo 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#, které 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 a vložte vzorový kód do souboru Program.cs vaší aplikace. Ujistěte se, že aktualizujete proměnnou klíče hodnotou z instance Služby Translator na webu Azure Portal:

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#

Jakmile do aplikace přidáte vzorový kód, vyberte vedle formRecognizer_quickstart zelené tlačítko Start a sestavte a spusťte program, nebo stiskněte klávesu F5.

Screenshot of the run program button in 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

To je to, blahopřejeme! Právě jste se naučili používat službu Translator k překladu textu.

Prozkoumejte naši dokumentaci s postupy a podrobněji se seznamte s možnostmi služby překladu: