Definieren von benutzerdefinierten Übersetzungen

Abgeschlossen

Während das Standardübersetzungsmodell von Azure KI Übersetzer für allgemeine Übersetzungen geeignet ist, müssen Sie möglicherweise eine Übersetzungslösung für Unternehmen oder Branchen entwickeln, die ein spezielles Vokabular an Begriffen haben, die eine individuelle Übersetzung erfordern.

Dazu können Sie ein benutzerdefiniertes Modell erstellen, das Ihre eigenen Sätze von Quell- und Zielbegriffen für die Übersetzung zuordnet. Verwenden Sie bei der Erstellung eines benutzerdefinierten Modells das Portal „Benutzerdefinierter Translator“ für Folgendes:

1. Erstellen eines Arbeitsbereichs, der mit Ihrer Azure KI Übersetzer-Ressource verknüpft ist
2. Erstellen eines Projekts
3. Hochladen von Trainingsdatendateien und Trainieren eines Modells
4. Testen Ihres Modells und Veröffentlichen Ihres Modells
5. Führen Sie Übersetzungsaufrufe an die API aus.

Ihrem benutzerdefinierten Modell wird eine eindeutige category Id zugewiesen (im Screenshot hervorgehoben), die Sie in translate-Aufrufen an Ihre Azure KI Übersetzer-Ressource mit dem Parameter category angeben können, so dass die Übersetzung durch Ihr benutzerdefiniertes Modell anstelle des Standardmodells durchgeführt wird.

Aufrufen der API

Um eine Übersetzung zu initiieren, senden Sie eine POST-Anforderung an die folgende Anforderungs-URL:

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

Ihre Anforderung muss einige Parameter enthalten:

• api-version: Die erforderliche Version der API
• to: Die Zielsprache, in die übersetzt werden soll Beispiel: to=fr für Französisch
• category: Ihre category Id

Ihre Anforderung muss auch eine Reihe von erforderlichen Headern enthalten:

• Ocp-Apim-Subscription-Key. Header für Ihren Clientschlüssel Beispiel: Ocp-Apim-Subscription-Key=<your-client-key>
• Content-Type. Der Inhaltstyp der Nutzdaten. Das erforderliche Format ist: Content-Type: application/json; charset=UTF-8

Der Anforderungstext sollte ein Array enthalten, das ein JSON-Objekt mit einer Eigenschaft Text enthält, die den Text angibt, den Sie übersetzen möchten:

[
    {"Text":"Where can I find my employee details?"}
]

Sie können Ihre Anforderungen auf verschiedene Weise an die API senden, unter anderem mit C#, Python und curl. Um einen schnellen Anruf zu tätigen, können Sie beispielsweise eine POST-Anforderung mit curl senden:

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

Die obige Anforderung ist ein Aufruf zur Übersetzung eines Satzes vom Englischen ins Niederländische.

Zurückgegebene Antwort

Die Antwort gibt den Antwortcode 200 zurück, wenn die Anforderung erfolgreich war. Außerdem wird ein Antworttext zurückgegeben, der den übersetzten Text enthält. Dies sieht wie folgt aus:

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

Wenn die Anforderung nicht erfolgreich war, kann je nach Fehlertyp eine Reihe unterschiedlicher Statuscodes zurückgegeben werden, z. B. 400 (fehlende oder ungültige Abfrageparameter). Eine vollständige Liste der Codes und deren Erklärung finden Sie unter Antwort-Statuscodes.

Hinweis

Weitere Informationen zur benutzerdefinierten Übersetzung finden Sie unter Schnellstart: Erstellen, Veröffentlichen und Übersetzen mit benutzerdefinierten Modellen.