Teilen über


Translator 3.0: Transliterate

Konvertiert Text in einer Sprache aus einem Skript in ein anderes Skript.

Anfrage-URL

Sendet eine POST-Anforderung an:

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

Weitere Informationen finden Sie unter "Virtual Network Support for Translator service selected network and private endpoint configuration and support".

Anforderungsparameter

Die folgenden Anforderungsparameter werden in der Abfragezeichenfolge übergeben:

Query parameter (Abfrageparameter) BESCHREIBUNG
api-version Erforderlicher Parameter.
Die vom Client angeforderte Version der API. Der Wert muss 3.0 sein.
language Erforderlicher Parameter.
Gibt die Sprache des Texts an, der von einem Skript in ein anderes konvertiert werden soll. Mögliche Sprachen sind im transliteration-Bereich aufgeführt, der durch Abfrage des Diensts nach den unterstützten Sprachen abgerufen wird.
fromScript Erforderlicher Parameter.
Gibt das vom Eingabetext verwendete Skript an. Suchen Sie mithilfe des transliteration-Bereichs nach unterstützten Sprachen, um Eingabeskripts zu finden, die für die ausgewählte Sprache verfügbar sind.
toScript Erforderlicher Parameter.
Gibt das Ausgabeskript an. Suchen Sie mithilfe des transliteration-Bereichs nach unterstützten Sprachen, um Ausgabeskripts zu finden, die für die ausgewählte Kombination aus Sprache und Eingabeskript verfügbar sind.

Anforderungsheader enthalten Folgendes:

Header Beschreibung
Authentifizierungsheader Erforderlicher Anforderungsheader.
Weitere Informationen finden Sie in den verfügbaren Optionen für die Authentifizierung.
Content-Type Erforderlicher Anforderungsheader.
Gibt den Inhaltstyp der Nutzlast an. Mögliche Werte sind: application/json
Content-Length Optional.
Die Länge des Anforderungstexts.
X-ClientTraceId Optional:
Eine vom Client erstellte GUID zur eindeutigen Identifizierung der Anforderung. Sie können diesen Header nur weglassen, wenn Sie die Ablaufverfolgungs-ID in die Abfragezeichenfolge über einen Abfrageparameter namens ClientTraceId einschließen.

Anforderungstext

Der Anforderungstext ist ein JSON-Array. Jedes Arrayelement ist ein JSON-Objekt mit einer Zeichenfolgeneigenschaft namens Text, die die zu suchende Zeichenfolge repräsentiert.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

Es gelten die folgenden Einschränkungen:

  • Das Array darf höchstens 10 Elemente enthalten.
  • Der Textwert eines Arrayelements darf 1.000 Zeichen (einschließlich Leerzeichen) nicht überschreiten.
  • Der gesamte Anforderungstext darf nicht mehr als 5.000 Zeichen enthalten (einschließlich Leerzeichen).

Antworttext

Eine erfolgreiche Antwort ist ein JSON-Array mit einem Ergebnis für jedes Element im Eingabearray. Ein Ergebnisobjekt enthält die folgenden Eigenschaften:

  • text: Dies ist eine Zeichenfolge, die aus der Konvertierung der Eingabezeichenfolge in das Ausgabeskript resultiert.

  • script: Eine Zeichenfolge, die das in der Ausgabe verwendete Skript angibt.

Eine JSON-Beispielantwort lautet wie folgt:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

Antwortheader

Header BESCHREIBUNG
X-RequestId Vom Dienst generierter Wert, um die Anforderung zu identifizieren und für Problembehandlungszwecke verwendet zu werden.

Antwortstatuscodes

Im Folgenden finden Sie die möglichen HTTP-Statuscodes, die eine Anforderung zurückgeben kann.

Statuscode BESCHREIBUNG
200 Erfolg.
400 Einer der Abfrageparameter fehlt oder ist ungültig. Korrigieren Sie die Anforderungsparameter, bevor Sie es erneut versuchen.
401 Die Anforderung konnte nicht authentifiziert werden. Überprüfen Sie, ob die Anmeldeinformationen angegeben und gültig sind.
403 Die Anforderung ist nicht autorisiert. Weitere Informationen finden Sie in der Fehlermeldung. Dieser Code gibt häufig an, dass alle kostenlosen Übersetzungen, die mit einem Testabonnement bereitgestellt werden, verwendet werden.
429 Der Server hat die Anforderung abgelehnt, da der Client die Anforderungsgrenzwerte überschritten hat.
500 Ein unerwarteter Fehler ist aufgetreten. Wenn der Fehler weiterhin besteht, melden Sie ihn, und gebe Sie Folgendes an: Datum und Zeitpunkt des Fehlers, Anforderungsbezeichner aus dem Anforderungsheader X-RequestId und Clientbezeichner aus dem Anforderungsheader X-ClientTraceId.
503 Der Server ist vorübergehend nicht verfügbar. Wiederholen Sie die Anforderung. Wenn der Fehler weiterhin besteht, melden Sie ihn, und gebe Sie Folgendes an: Datum und Zeitpunkt des Fehlers, Anforderungsbezeichner aus dem Anforderungsheader X-RequestId und Clientbezeichner aus dem Anforderungsheader X-ClientTraceId.

Sollte ein Fehler auftreten, gibt die Anforderung auch eine JSON-Fehlerantwort zurück. Der Fehlercode ist eine 6-stellige Zahl, die aus dem 3-stelligen HTTP-Statuscode gefolgt von einer 3-stelligen Zahl zur Kategorisierung des Fehlers besteht. Häufige Fehlercodes finden Sie in der Referenz zu Version 3 von Translator.

Beispiele

Das folgende Beispiel zeigt, wie Sie zwei japanische Zeichenfolgen in lateinische Buchstaben konvertieren.

Die JSON-Nutzlast für die Anforderung in diesem Beispiel:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

Wenn Sie cURL in einem Befehlszeilenfenster verwenden, das keine Unicode-Zeichen unterstützt, verwenden Sie die folgende JSON-Nutzlast, und speichern Sie sie in eine Datei namens request.txt. Stellen Sie sicher, dass Sie diese Datei mit UTF-8-Codierung speichern.

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt