Container: Transliterate Text

Artikel
09/01/2024

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

Sie können den Dienst nach transliteration unterstützten Sprachen abfragen.
Siehe auch Sprachunterstützung für Transliteration.

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

Weitere Informationen zur Texttransliteration

Teilen über