Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure Text translation is a cloud-based REST API feature of the Translator service that uses neural machine translation technology to enable quick and accurate source-to-target text translation in echtzeit across all supported languages. In dieser Übersicht erfahren Sie, wie Sie mit den REST-APIs für die Textübersetzung intelligente Lösungen für Ihre Anwendungen und Workflows erstellen können.
Die Textübersetzungsdokumentation enthält die folgenden Artikeltypen:
- Schnellstarts. Anleitungen für die ersten Schritte, die Sie durch das Senden von Anforderungen an den Dienst führen.
- Anleitungen. Anweisungen für den Zugriff und die Verwendung des Diensts auf spezifischere oder angepasste Weise.
- Referenzartikel. REST-API-Dokumentation und programmiersprachebasierte Inhalte.
Textübersetzungsfeatures
Mit der neuesten Vorschauversion können Sie optional entweder die Standardübersetzung für neurale Computer (NMT) oder eine LLM-Bereitstellung (Large Language Model) (GPT-4o-mini oder GPT-4o) auswählen. Die Verwendung eines LLM-Modells erfordert jedoch, dass Sie über eine Azure AI Foundry-Ressource verfügen. Weitere Informationen finden Sie unterKonfigurieren von Azure-Ressourcen.
Sprachen. Gibt eine Liste der Sprachen zurück, die von den Übersetzungs - und Transliterate-APIs unterstützt werden. Diese Anforderung erfordert keine Authentifizierung; Kopieren Sie einfach die folgende
GETAnforderung, und fügen Sie sie in Ihr bevorzugtes REST-API-Tool oder Browser ein:https://api.cognitive.microsofttranslator.com/languages?api-version=2025-05-01-previewÜbersetzen. Rendert einzelnen Quellsprachtext in mehreren Zielsprachtexten mit einer einzigen
POSTAnforderung:Transliterat. Konvertiert Zeichen oder Buchstaben einer Quellsprache in die entsprechenden Zeichen oder Buchstaben einer Zielsprache mit einer einzigen
POSTAnforderung.
Bereitstellungsoptionen für Textübersetzungen
Fügen Sie Textübersetzung zu Ihren Projekten und Anwendungen mithilfe der folgenden Ressourcen hinzu:
Greifen Sie über die REST-API, die in Azure verfügbar ist, auf den cloudbasierten Übersetzerdienst zu.
Verwenden Sie die REST-API-Übersetzungsanforderung mit dem Docker-Container "Textübersetzung".
Von Bedeutung
Um den Übersetzercontainer verwenden zu können, müssen Sie die Azure AI-Dienstanwendung für Gated Services online anfordern, um den Zugriff auf den Container zu genehmigen.
Das Translator-Containerimage unterstützt eingeschränkte Features im Vergleich zu Cloudangeboten.
Datenresidenz
Die Datenaufbewahrung von Textübersetzungen hängt von der Azure-Region ab, in der Ihre Übersetzerressource erstellt wurde:
Residency für Textübersetzungsdaten
✔️ Feature: Übersetzertext
| Dienstendpunkt | Datenverarbeitungscenter anfordern |
|---|---|
Global (empfohlen):api.cognitive.microsofttranslator.com |
Nächstgelegenes verfügbares Rechenzentrum. |
Amerika:api-nam.cognitive.microsofttranslator.com |
Ost-USA 2 • West-USA 2 |
Asien-Pazifik:api-apc.cognitive.microsofttranslator.com |
Japan Ost • Südostasien |
Europa (mit Ausnahme der Schweiz):api-eur.cognitive.microsofttranslator.com |
Frankreich Zentral • Westeuropa |
|
Schweiz: Weitere Informationen finden Sie inden Dienstendpunkten der Schweiz. |
Schweiz Nord • Schweiz West |
Endpunkte der Schweiz
Kunden mit einer Ressource in der Schweiz Nord- oder Schweiz West können sicherstellen, dass ihre Text-API-Anforderungen innerhalb der Schweiz bedient werden. Um sicherzustellen, dass Anforderungen in der Schweiz verarbeitet werden, erstellen Sie die Übersetzerressource im Resource regionSwitzerland North oder Switzerland Westverwenden Sie dann den benutzerdefinierten Endpunkt der Ressource in Ihren API-Anforderungen.
Beispiel: Wenn Sie eine Übersetzerressource im Azure-Portal mit Resource region dem Switzerland North Namen ihrer Ressource erstellen, lautet my-swiss-nder benutzerdefinierte Endpunkt https​://my-swiss-n.cognitiveservices.azure.com. Und eine Beispielanforderung für die Übersetzung lautet:
// 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 ist derzeit in der Schweiz nicht verfügbar.
Erste Schritte mit der Textübersetzung
Sind Sie bereit, um zu beginnen?
Erstellen einer Übersetzerressource im Azure-Portal.
Rufen Sie Ihre Zugriffstasten und den API-Endpunkt ab. Für die Authentifizierung sind eine Endpunkt-URL und ein schreibgeschützter Schlüssel erforderlich.
Erkunden Sie unsere Schnellstartanleitung "Lernen Sie die Verwendung von Übersetzern über REST und eine bevorzugte Programmiersprache".) und Anzeigen von Anwendungsfällen und Codebeispielen für die folgenden Programmiersprachen:
Nächste Schritte
Tauchen Sie tiefer in die REST-API für die Textübersetzung ein: