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 Translator in Foundry Tools ist ein cloudbasiertes REST-API-Feature von Translator, das neurale maschinelle Übersetzungstechnologie verwendet, um eine schnelle und genaue Textübersetzung in Echtzeit in allen unterstützten Sprachen zu ermöglichen. 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 standardmäßige neurale maschinelle Übersetzung (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 Microsoft 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-10-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.
Optionen für die Entwicklung von Textübersetzungen
Fügen Sie Textübersetzung zu Ihren Projekten und Anwendungen mithilfe der folgenden Ressourcen hinzu:
| Entwicklungsoption | Description |
|---|---|
| Foundry | • Foundry (classic) Portal ist eine cloudbasierte KI-Plattform, die Hub-basierte Projekte und andere Ressourcentypen unterstützt. •Foundry (neues) Portal ist eine cloudbasierte KI-Plattform, die einen optimierten Zugriff auf Foundry-Modelle, Agenten und Tools über Foundry-Projekte bietet. |
| REST-API | Integrieren Sie die Übersetzung in Ihre Anwendungen mithilfe der REST-API-Version (GA) oder der REST-API (Vorschauversion). |
| Clientbibliotheken (SDKs) | Beginnen Sie mit der Integration von Übersetzungsfunktionen in Ihre Anwendungen mithilfe einer unserer Clientbibliotheken (SDKs), die in verschiedenen Programmiersprachen verfügbar sind. |
| Docker-Container | • Um den Übersetzer-Container zu verwenden, müssen Sie die Findry Tools-Anwendung für Gated Services Online-Anforderungsformular zur Genehmigung für den Zugriff auf den Container ausfüllen und übermitteln. • Das Translator-Containerimage unterstützt eingeschränkte Features im Vergleich zu Cloudangeboten. Weitere Informationen finden Sie unterContainer: Übersetzen von Text. |
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 des Übersetzers ü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: