Azure-resources voor Translator

• Een Foundry-resource is uw belangrijkste hulpprogramma voor het maken, implementeren en beheren van generatieve AI-toepassingen en -agents. Met deze resource hebt u toegang tot agentservices, kunt u modellen gebruiken die worden gehost in een serverloze omgeving, evaluaties uitvoeren en verbinding maken met de Azure OpenAI-service.
  

• Als u van plan bent om een LLM-model te gebruiken voor vertaling, moet u een Foundry-resource gebruiken.
  

• ZieUw eerste Foundry-resource maken en beheren voor meer informatie over het maken en beheren van een Foundry-resource

Een Azure Translator-resource is een exemplaar van de service die u maakt. Alle API-aanvragen voor Foundry Tools kunnen worden geopend met een eindpunt-URL en een alleen-lezen sleutel voor verificatie van toegang.

Vereiste voorwaarden

U hebt een actief Azure-account nodig om aan de slag te gaan.

Maak uw Azure Translator-resource aan

Met uw Azure-account hebt u toegang tot Translator via twee verschillende resourcetypen:

• Resourcetypen met één service bieden toegang tot één API-sleutel en eindpunt voor één service.

• Resourcetypen voor meerdere services maken toegang tot meerdere Foundry Tools mogelijk met behulp van één API-sleutel en eindpunt.

Voltooi de details van uw project en instance

Nadat u hebt bepaald welk resourcetype u wilt gebruiken om toegang te krijgen tot Translator, kunt u de details voor uw project en exemplaar invoeren.

1. Abonnement. Selecteer een van uw beschikbare Azure-abonnementen.

2. Resourcegroep. U kunt een nieuwe resourcegroep maken of uw resource toevoegen aan een bestaande resourcegroep die dezelfde levenscyclus, machtigingen en beleidsregels deelt.

3. Resourceregio. Kies Globaal , tenzij uw bedrijf of toepassing een specifieke regio vereist. Voordat u een regio selecteert, controleert u de ondersteuning voor regio's voor Azure Translator. Als u van plan bent documentomzetting te gebruiken met beheerde identiteitsautorisatie, kiest u een geografische regio, zoals VS - oost.

4. Name. Voer een naam in voor uw resource. De naam die u kiest, moet uniek zijn binnen Azure.

   Opmerking

   Als u een Translator-functie gebruikt die een aangepast domeineindpunt nodig heeft, zoals documentomzetting, wordt de invoer in het name veld gebruikt als de parameter voor de aangepaste domeinnaam voor het eindpunt.

Zorg ervoor dat u de juiste waarde in het name veld invoert om de juiste functionaliteit te garanderen.

1. Prijscategorie. Selecteer een prijscategorie die aan uw behoeften voldoet:

   • Elk abonnement heeft een gratis laag.
   • De gratis laag heeft dezelfde functies en functionaliteit als de betaalde abonnementen en verloopt niet.
   • Er is per abonnement slechts één resource in de gratis laag beschikbaar.
   • Documentvertaling is beschikbaar in betaalde abonnementen. Language Studio ondersteunt alleen de S1- of D3-exemplaarlagen. Als u alleen documentomzetting wilt proberen, selecteert u de standard S1-exemplaarlaag.

2. Als u een resource met meerdere services hebt gemaakt, bevat de koppelingen onder aan het tabblad Basisinformatie technische documentatie over de juiste werking van de service.

3. Selecteer Beoordelen en Creëren.

4. Controleer de servicevoorwaarden en selecteer Maken om uw resource te implementeren.

5. Nadat de resource is geïmplementeerd, selecteert u Ga naar de resource.

Verificatiesleutels en eindpunt-URL

De snelste methode voor het verifiëren van uw Foundry Tools API-aanvragen is het opnemen van uw eindpunt-URL en een alleen-lezen sleutel in een verificatieheader. Zie Verificatie en autorisatie voor meer informatie

• Verificatiesleutels. Uw sleutel is een unieke tekenreeks die bij elk verzoek aan de vertaaldienst wordt meegegeven. U kunt uw sleutel doorgeven via een queryreeksparameter of door deze op te geven in de HTTP-aanvraagheader.

• Eindpunt-URL. Gebruik het globale eindpunt in uw API-aanvraag, tenzij u een specifieke Azure-regio of een aangepast eindpunt nodig hebt. Zie Basis-URL's voor meer informatie. De URL van het globale eindpunt is api.cognitive.microsofttranslator.com.

Uw verificatiesleutels en eindpunt ophalen

Als u de verbinding met uw Translator-resource wilt verifiëren, hebt u de sleutel en het eindpunt voor uw resource nodig.

1. Nadat de nieuwe resource is geïmplementeerd, selecteert u Ga naar de resource of gaat u naar de resourcepagina.
2. Selecteer sleutels en eindpunt in het linkerdeelvenster onder Resourcebeheer.
3. Kopieer en plak uw sleutels en eindpunt-URL op een handige locatie, zoals Kladblok.

Een tekstvertalingsclient maken

Tekstomzetting ondersteunt zowel globale als regionale eindpunten. Zodra u uw verificatiesleutels hebt, moet u een exemplaar van de TextTranslationClient, met behulp van een AzureKeyCredential voor verificatie, maken om te communiceren met de tekstvertalingsservice:

• Als u een TextTranslationClient wilt maken met een algemeen resource-eindpunt, hebt u de API-sleutel van de resource nodig:

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

• Als u een TextTranslationClient eindpunt voor een regionale resource wilt maken, hebt u uw resource-API-sleutel en de naam nodig van de regio waar uw resource zich bevindt:

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

Aan de slag met Azure Translator REST API's

In onze quickstart leert u hoe u translator gebruikt met REST API's.