Wat is Azure Text Translation?
Azure Text Translation is een cloudgebaseerde REST API-functie van de Translator-service die gebruikmaakt van technologie voor neurale machinevertaling om snel en nauwkeurig tekstvertaling naar doel in realtime in alle ondersteunde talen mogelijk te maken. In dit overzicht leert u hoe u met de REST API's voor tekstomzetting intelligente oplossingen kunt bouwen voor uw toepassingen en werkstromen.
Documentatie voor tekstomzetting bevat de volgende artikeltypen:
- Snelstartgidsen. Aan de slag-instructies om u te begeleiden bij het indienen van aanvragen bij de service.
- Procedures. Instructies voor het openen en gebruiken van de service op specifiekere of aangepaste manieren.
- Naslagartikelen. REST API-documentatie en inhoud op basis van programmeertalen.
Functies voor tekstomzetting
Tekstomzetting ondersteunt de volgende methoden:
Talen. Retourneert een lijst met talen die worden ondersteund door bewerkingen vertalen, transliteratie en opzoeken in woordenlijsten. Voor deze aanvraag is geen verificatie vereist; kopieer en plak de volgende GET-aanvraag in uw favoriete REST API-hulpprogramma of browser:
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0Vertalen. Hiermee wordt tekst in één brontaal weergegeven in meerdere doeltaalteksten met één aanvraag.
Transliteratie. Converteert tekens of letters van een brontaal naar de bijbehorende tekens of letters van een doeltaal.
Detecteren. Retourneert de broncodetaalcode en een Booleaanse variabele die aangeeft of de gedetecteerde taal wordt ondersteund voor tekstomzetting en transliteratie.
Notitie
U kunt tekst vertalen, transliteratie en detecteren met één REST API-aanroep .
Opzoeken van woordenlijst. Retourneert equivalente woorden voor de bronterm in de doeltaal.
Woordenlijstvoorbeeld retourneert grammaticale structuur en contextvoorbeelden voor de bronterm en het doeltermpaar.
Implementatieopties voor tekstomzetting
Voeg tekstomzetting toe aan uw projecten en toepassingen met behulp van de volgende bronnen:
Open de Translator-service in de cloud via de REST API, die beschikbaar is in Azure.
Gebruik de REST API-aanvraag voor vertalen met de Docker-container voor tekstomzetting.
Belangrijk
Als u de Translator-container wilt gebruiken, moet u de Azure AI-servicestoepassing voor het onlineaanvraagformulier Gated Services voltooien en indienen en deze laten goedkeuren om toegang tot de container te verkrijgen.
De Translator-containerinstallatiekopieën ondersteunen beperkte functies vergeleken met cloudaanbiedingen.
Gegevensresidentie
Gegevenslocatie voor tekstomzetting is afhankelijk van de Azure-regio waarin uw Translator-resource is gemaakt:
Gegevenslocatie voor tekstomzetting
✔️ Functie: Translator Text
| Service-eindpunt | Gegevensverwerkingscentrum aanvragen |
|---|---|
Algemeen (aanbevolen):api.cognitive.microsofttranslator.com |
Dichtstbijzijnde beschikbare datacentrum. |
Amerika:api-nam.cognitive.microsofttranslator.com |
VS - oost 2 • VS - west 2 |
Azië en Stille Oceaanapi-apc.cognitive.microsofttranslator.com: |
Japan - oost • Azië - zuidoost |
Europa (behalve Zwitserland):api-eur.cognitive.microsofttranslator.com |
Frankrijk - centraal • Europa - west |
| Zwitserland: Zie De service-eindpunten van Zwitserland voor meer informatie . |
Zwitserland - noord • Zwitserland - west |
Service-eindpunten van Zwitserland
Klanten met een resource in Zwitserland - noord of Zwitserland - west kunnen ervoor zorgen dat hun Text-API-aanvragen binnen Zwitserland worden verwerkt. Als u ervoor wilt zorgen dat aanvragen worden verwerkt in Zwitserland, maakt u de Translator-resource in het Resource region Switzerland North of Switzerland Westgebruikt u vervolgens het aangepaste eindpunt van de resource in uw API-aanvragen.
Bijvoorbeeld: Als u een Translator-resource maakt in Azure Portal met Resource region de Switzerland North naam van uw resource, is my-swiss-nhttps​://my-swiss-n.cognitiveservices.azure.comuw aangepaste eindpunt. En een voorbeeldaanvraag om te vertalen is:
// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v
Custom Translator is momenteel niet beschikbaar in Zwitserland.
Aan de slag met tekstomzetting
Klaar om te beginnen?
Maak een Translator-resource in Azure Portal.
Haal uw toegangssleutels en API-eindpunt op. Er zijn een eindpunt-URL en alleen-lezensleutel vereist voor verificatie.
Bekijk onze quickstart en bekijk use cases en codevoorbeelden voor de volgende programmeertalen:
Volgende stappen
Meer informatie over de REST API voor tekstomzetting: