Freigeben über


Container: Transliterate Text

Konvertieren Sie Zeichen oder Buchstaben einer Quellsprache in die entsprechenden Zeichen oder Buchstaben einer Zielsprache.

Anforderungs-URL

POST bitten:

 POST http://localhost:{port}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

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 Bedingung
api-version Die vom Client angeforderte Version der API. Der Wert muss 3.0 sein. Erforderlicher Parameter
language Gibt die Quellsprache des Texts an, der von einem Skript in ein anderes konvertiert werden soll. Erforderlicher Parameter
fromScript Gibt das vom Eingabetext verwendete Skript an. Erforderlicher Parameter
toScript Gibt das Ausgabeskript an. Erforderlicher Parameter

Anforderungsheader

Header Beschreibung Bedingung
Authentifizierungsheader Verfügbare Optionen für die Authentifizierung anzeigen Erforderlicher Anforderungsheader
Inhaltsart Gibt den Inhaltstyp der Nutzlast an. Möglicher Wert: application/json Erforderlicher Anforderungsheader
Content-Length Die Länge des Anforderungstexts. Optional
X-ClientTraceId 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. Optional

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.

Antwortheader

Header BESCHREIBUNG
X-RequestId Der Wert, der vom Dienst für die Identifizierung der Anforderung generiert wird. Sie kann für Problembehandlungszwecke verwendet werden.

Beispielanforderung

curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn"

Beispielanforderungstext

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 kann maximal 10 Elemente aufweisen.
  • 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).

JSON-Beispielantwort:

[
  {
    "text": "Kon'nichiwa​",
    "script": "Latn"
  },
  {
    "text": "sayonara",
    "script": "Latn"
  }
]

Hinweis

  • Jedes Beispiel wird für das localhost mit dem docker run Befehl angegebene Beispiel ausgeführt.
  • Zeigt während der Ausführung localhost des Containers auf den Container selbst.
  • Sie müssen nicht verwenden localhost:5000. Sie können jeden Port verwenden, der in Ihrer Hostumgebung noch nicht verwendet wird.

Transliterat mit REST-API


  curl -X POST "http://localhost:5000/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "Content-Type: application/json" -d "[{'Text':'こんにちは'},{'Text':'さようなら'}]"

Nächste Schritte