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.
Was ist neu?
Version 3.0 des Übersetzers stellt eine moderne JSON-basierte Web-API bereit. Sie verbessert die Benutzerfreundlichkeit und Leistung, indem vorhandene Features in weniger Vorgänge konsolidiert werden und neue Features bereitgestellt werden.
- Transliteration zum Konvertieren von Text in einer Sprache von einem Skript in ein anderes Skript.
- Übersetzung in mehrere Sprachen in einer Anforderung.
- Spracherkennung, Übersetzung und Transliteration in einer Anforderung.
- Wörterbuch zum Nachschlagen alternativer Übersetzungen eines Begriffs, um Back-Übersetzungen und Beispiele zu finden, die ausdrücken, die im Kontext verwendet werden.
- Informativere Spracherkennungsergebnisse.
Basis-URLs
Die globale Basis-URL lautet https://api.cognitive.microsofttranslator.com. Textübersetzung unterstützt auch geografie- und ressourcenspezifische Endpunkte. Informationen zu allen Endpunkt-URLs und ihren Anforderungsverarbeitungsspeicherorten finden Sie unter Regionsunterstützung für Azure Translator.
Virtual Network-Support
Der Übersetzer ist jetzt mit Virtual Network -Funktionen (VNET) in allen Regionen der Azure öffentlichen Cloud verfügbar. Um Virtual Network zu aktivieren, SeeConfiguring Foundry Tools virtual networks.
Nachdem Sie diese Funktion aktiviert haben, müssen Sie den benutzerdefinierten Endpunkt verwenden, um den Übersetzer aufzurufen. Sie können den globalen Übersetzerendpunkt ("api.cognitive.microsofttranslator.com") nicht verwenden, und Sie können sich nicht mit einem Zugriffstoken authentifizieren.
Sie können den benutzerdefinierten Endpunkt finden, nachdem Sie eine Übersetzerressource erstellt und den Zugriff von ausgewählten Netzwerken und privaten Endpunkten zulassen.
Navigieren Sie im Azure-Portal zu Ihrer Übersetzerressource.
Wählen Sie im Abschnitt Ressourcenverwaltung die Option Netzwerk aus.
Wählen Sie auf der Registerkarte Firewalls und virtuelle Netzwerke die Option Ausgewählte Netzwerke und private Endpunkte aus.
Wählen Sie "Speichern" aus, um Ihre Änderungen anzuwenden.
Wählen Sie "Schlüssel" und "Endpunkt " im Abschnitt "Ressourcenverwaltung " aus.
Wählen Sie die Registerkarte Virtual Network aus.
Hier sind die Endpunkte für die Textübersetzung und die Dokumentübersetzung aufgeführt.
| Headers | Beschreibung |
|---|---|
| Ocp-Apim-Subscription-Key | Der Wert ist der Azure geheimer Schlüssel für Ihr Abonnement von Translator. |
| Ocp-Apim-Subscription-Region | Der Wert ist der Bereich der Übersetzerressource. Dieser Wert ist optional, wenn die Ressource global |
Hier ist eine Beispielanforderung zum Aufrufen des Übersetzers mithilfe des benutzerdefinierten Endpunkts.
// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
-H "Ocp-Apim-Subscription-Key:<your-key>" \
-H "Ocp-Apim-Subscription-Region:<your-region>" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello, what is your name?'}]"
Metrics
Mithilfe von Metriken können Sie die Informationen zur Übersetzernutzung und -verfügbarkeit im Azure Portal anzeigen. Weitere Informationen finden Sie unter Daten- und Plattformmetriken.
In dieser Tabelle sind die verfügbaren Metriken aufgeführt, die beschreiben, wie sie zum Überwachen von Übersetzungs-API-Aufrufen verwendet werden.
| Metrics | Beschreibung |
|---|---|
| TotalCalls | Gesamtanzahl der API-Aufrufe. |
| TotalTokenCalls | Die Gesamtzahl der API-Aufrufe über den Tokendienst mithilfe des Authentifizierungstokens. |
| SuccessfulCalls | Anzahl erfolgreicher Aufrufe |
| TotalErrors | Anzahl der Anrufe mit Fehlerantwort. |
| BlockedCalls | Anzahl von Aufrufen, die das Raten- oder Kontingentlimit überschritten haben |
| ServerFehler | Anzahl der Anrufe mit internem Serverfehler(5XX). |
| ClientErrors | Anzahl der Anrufe mit clientseitigem Fehler(4XX). |
| Latenz | Dauer zum Abschließen der Anforderung in Millisekunden. |
| CharactersTranslated | Gesamtanzahl von Zeichen in einer eingehenden Textanforderung |