Bewerken

Delen via


Een Translator-resource maken

In dit artikel leert u hoe u een Translator-resource maakt in Azure Portal. Azure AI Translator is een cloudservice voor machinevertaling die deel uitmaakt van de Azure AI-servicesfamilie . Azure-resources zijn exemplaren van services die u maakt. Alle API-aanvragen voor Azure AI-services vereisen een eindpunt-URL en een alleen-lezen sleutel voor het verifiëren van toegang.

Vereisten

U hebt een actief Azure-account nodig om aan de slag te gaan. Als u nog geen abonnement hebt, kunt u een gratis abonnement van 12 maanden maken.

Uw resource maken

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

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

  2. Resourcetypen voor meerdere services maken toegang tot meerdere Azure AI-services mogelijk met behulp van één API-sleutel en eindpunt.

Details van uw project en exemplaar voltooien

Nadat u hebt bepaald welk resourcetype u wilt gebruiken voor toegang tot de Translator-service, 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. Als u van plan bent om de functie Documentvertaling te gebruiken met autorisatie voor beheerde identiteiten, 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.

    Notitie

    Als u een Translator-functie gebruikt waarvoor een aangepast domeineindpunt is vereist, zoals Documentomzetting, is de waarde die u invoert in het veld Naam de parameter voor de aangepaste domeinnaam voor het eindpunt.

  5. 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 slechts één resource in de gratis laag beschikbaar per abonnement.
    • Documentomzetting wordt alleen ondersteund in de betaalde laag. Language Studio ondersteunt de S1- en D3-exemplaarlagen. Als u alleen documentomzetting wilt proberen, selecteert u de standard S1-exemplaarlaag.
  6. Als u een resource met meerdere services maakt, bieden de koppelingen onder aan het tabblad Basisinformatie technische documentatie over de juiste werking van de service.

  7. Selecteer Controleren + maken.

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

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

    Verificatiesleutels en eindpunt-URL

    Alle API-aanvragen van Azure AI-services vereisen een eindpunt-URL en een alleen-lezen sleutel voor verificatie.

    • Verificatiesleutels. Uw sleutel is een unieke tekenreeks die wordt doorgegeven aan elke aanvraag aan de vertaalservice. 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, moet u de sleutels en het eindpunt ervan vinden.

  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 linkernavigatiedeelvenster onder Resourcebeheer.

  3. Kopieer en plak uw sleutels en eindpunt-URL op een handige locatie, zoals Kladblok.

    Schermopname van Azure Portal met de pagina Sleutels en Eindpunt van een Translator-resource. De sleutels en eindpunten zijn gemarkeerd.

Een tekstomzettingsclient 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 service Tekstvertaling:

  1. Als u een TextTranslationClient globaal resource-eindpunt wilt maken, hebt u uw resource-API-sleutel nodig:

      AzureKeyCredential credential = new('<apiKey>');
      TextTranslationClient client = new(credential);
    
  2. 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>');
    

Een documentomzettingsclient maken

Gebruik de documentomzettings-API om grote hoeveelheden tekst en meerdere documenten in verschillende talen asynchroon te vertalen. Voor het batchvertalingsproces is een Azure Blob Storage-account met opslagcontainers vereist voor uw bron- en vertaalde documenten.

  1. Documentomzetting wordt momenteel ondersteund in de Translator-resource (één service) met behulp van S1 Standard Service Plan (betalen per gebruik) of in het D3-volumekortingsplan.

  2. "Zie Vereisten: Documentomzetting gebruiken voor meer informatie over het maken van een Translator-resource voor documentvertaling.

Een resource of resourcegroep verwijderen

Waarschuwing

Als u een resourcegroep verwijdert, worden ook alle resources in de groep verwijderd.

De resource verwijderen:

  1. Zoek en selecteer resourcegroepen in Azure Portal en selecteer uw resourcegroep.

  2. Selecteer de resources die u wilt verwijderen door het aangrenzende selectievakje in te schakelen.

  3. Selecteer Verwijderen in het bovenste menu aan de rechterkant.

  4. Voer verwijderen in het dialoogvenster Resources verwijderen in.

  5. Selecteer Verwijderen.

De resourcegroep verwijderen:

  1. Ga naar uw resourcegroep in Azure Portal.

  2. Selecteer Resourcegroep verwijderen in de bovenste menubalk.

  3. Bevestig de verwijderingsaanvraag door de naam van de resourcegroep in te voeren en Verwijderen te selecteren.

Volgende stap