Was ist Azure Text Translation?
Bei Azure Text Translation handelt es sich um ein cloudbasiertes REST-API-Feature des Übersetzungsdiensts, das die Technologie der neuronalen maschinellen Übersetzung verwendet, um eine schnelle und genaue Übersetzung von Ausgangstext zu Zieltext in Echtzeit in allen unterstützten Sprachen zu ermöglichen. In dieser Übersicht erfahren Sie, wie Sie mit den Text Translation-REST-APIs intelligente Lösungen für Ihre Anwendungen und Workflows erstellen können.
Die Dokumentation zur Textübersetzung enthält die folgenden Arten von Artikeln:
- Schnellstarts. Anleitungen zu den ersten Schritten, die Sie durch das Senden von Anforderungen an den Dienst führen.
- Schrittanleitungen. Anweisungen für den Zugriff auf den Dienst und zur spezifischeren oder individuelleren Verwendung des Diensts.
- Referenzartikel. REST-API-Dokumentation und von der Programmiersprache abhängige Inhalte.
Features für die Textübersetzung
Text Translation unterstützt die folgenden Methoden:
Sprachen. Gibt eine Liste der Sprachen zurück, die von den Vorgängen Übersetzen, Transliterieren und Wörterbuchsuche unterstützt werden. Für diese Anforderung ist keine Authentifizierung erforderlich. Kopieren Sie einfach die folgende GET-Anforderung, und fügen Sie sie in Ihr bevorzugtes REST-API-Tool oder Ihren Browser ein:
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0Übersetzen. Rendert Text in einer einzelnen Quellsprache mit einer einzelnen Anforderung in Texte in mehreren Zielsprachen.
Transliterieren. Konvertiert Zeichen oder Buchstaben einer Quellsprache in die entsprechenden Zeichen oder Buchstaben einer Zielsprache.
Erkennen. Gibt den Sprachcode des Quellcodes und eine boolesche Variable zurück, die angibt, ob die erkannte Sprache für die Textübersetzung und Transliteration unterstützt wird.
Hinweis
Sie können Text mit einem einzelnen REST-API-Aufrufübersetzen, transliterieren und erkennen.
Wörterbuchsuche. Gibt äquivalente Wörter für den Quellbegriff in der Zielsprache zurück.
Wörterbuchbeispiel. Gibt die grammatikalische Struktur und Kontextbeispiele für das Paar aus Quell- und Zielbegriff zurück.
Bereitstellungsoptionen für die Textübersetzung
Fügen Sie Ihren Projekten und Anwendungen mithilfe der folgenden Ressourcen die Textübersetzung hinzu:
Greifen Sie über die REST-API auf den cloudbasierten Textübersetzungsdienst zu, der in Azure verfügbar ist.
Verwenden Sie die Übersetzungsanforderung der REST-API mit dem Docker-Container für die Textübersetzung.
Wichtig
Wenn Sie den Container für den Übersetzer verwenden möchten, müssen Sie das Onlineanforderungsformular für Azure KI Services-Anwendung für geschlossene Dienste ausfüllen, übermitteln und genehmigen lassen, um Zugriff auf den Container zu erhalten.
Das Containerimage für die Textübersetzung unterstützt im Vergleich zu den Cloudangeboten eingeschränkte Features.
Datenresidenz
Die Datenresidenz der Textübersetzung hängt von der Azure-Region ab, in der Ihre Textübersetzungsressource erstellt wurde:
Datenresidenz von Textübersetzungen
✔️ Feature: Textübersetzung
| Dienstendpunkt | Rechenzentrum für die Anforderungsverarbeitung |
|---|---|
Global (empfohlen):api.cognitive.microsofttranslator.com |
Nächstgelegenes verfügbares Rechenzentrum. |
Nord-, Mittel- und Südamerika:api-nam.cognitive.microsofttranslator.com |
USA, Osten 2 • USA, Westen 2 |
Asien-Pazifik:api-apc.cognitive.microsofttranslator.com |
Japan, Osten • Asien, Südosten |
Europa (außer der Schweiz):api-eur.cognitive.microsofttranslator.com |
Frankreich, Mitte • Europa, Westen |
| Schweiz: Weitere Informationen finden Sie unter Dienstendpunkte für die Schweiz. |
Schweiz, Norden • Schweiz, Westen |
Dienstendpunkte der Schweiz
Kunden mit einer Ressource in „Schweiz, Norden“ oder „Schweiz, Westen“ können sicherstellen, dass ihre Text-API-Anforderungen innerhalb der Schweiz verarbeitet werden. Um sicherzustellen, dass Anforderungen in der Schweiz verarbeitet werden, erstellen Sie die Übersetzerressource in Resource region Switzerland North oder Switzerland West. Verwenden Sie dann den benutzerdefinierten Endpunkt der Ressource in Ihren API-Anforderungen.
Beispiel: Wenn Sie im Azure-Portal eine Übersetzerressource mit Resource region als Switzerland North erstellen und Ihre Ressource den Namen „my-swiss-n“ hat, lautet Ihr benutzerdefinierter Endpunkt „https​://my-swiss-n.cognitiveservices.azure.com“. Eine Beispielanforderung für die Übersetzung wäre etwa:
// 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
Die Funktion „Benutzerdefinierter Translator“ ist in der Schweiz derzeit nicht verfügbar.
Erste Schritte bei der Textübersetzung
Bereit für den Einstieg?
Erstellen Sie eine Translator-Ressource im Azure-Portal.
Rufen Sie Ihre Zugriffsschlüssel und den API-Endpunkt ab. Für die Authentifizierung sind eine Endpunkt-URL und ein schreibgeschützter Schlüssel erforderlich.
Lesen Sie die Schnellstartanleitung, und sehen Sie sich die Anwendungsfälle und Codebeispiel für die folgenden Programmiersprachen an:
Nächste Schritte
Ausführlichere Informationen zur Textübersetzungs-REST-API:
Weitere Informationen finden Sie in der REST-API-Referenz.