Translator - Transliterate

Dienst:

Azure AI Services

API-Version:

3.0

Wandelt den Text einer Sprache in einem Skript in einen anderen Skripttyp um. Beispiel: Japanische Schrift "こんにちは" Dasselbe Wort im lateinischen Skript "konnichiha"

POST {Endpoint}/transliterate?api-version=3.0&language={language}&fromScript={fromScript}&toScript={toScript}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte
api-version	query	True	string	Version der API, die vom Client angefordert wird. Der Wert muss 3,0sein.
fromScript	query	True	string	Gibt das skript an, das vom Eingabetext verwendet wird. Nachschlagen unterstützter Sprachen mithilfe des transliteration Bereichs, um Eingabeskripts zu finden, die für die ausgewählte Sprache verfügbar sind.
language	query	True	string	Gibt die Sprache des Texts an, der von einem Skript in ein anderes konvertiert werden soll. Mögliche Sprachen werden im transliteration Bereich aufgelistet, der durch Abfragen des Diensts für die unterstützten Sprachen abgerufen wird.
toScript	query	True	string	Gibt das Ausgabeskript an. Nachschlagen unterstützter Sprachen mithilfe des transliteration Bereichs, um Ausgabeskripts zu finden, die für die ausgewählte Kombination aus Eingabesprache und Eingabeskript verfügbar sind.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
X-ClientTraceId		string	Eine vom Client generierte GUID, um die Anforderung eindeutig zu identifizieren. Beachten Sie, dass Sie diesen Header weglassen können, wenn Sie die Ablaufverfolgungs-ID in die Abfragezeichenfolge mithilfe eines Abfrageparameters namens "ClientTraceId" einschließen.

Anforderungstext

Name	Typ	Beschreibung
texts	TransliterateTextInput[]	Anforderungstext Der Textkörper der Anforderung ist ein JSON-Array. Jedes Arrayelement ist ein JSON-Objekt mit einer Zeichenfolgeneigenschaft namens Text, die die zu konvertierende Zeichenfolge darstellt. Die folgenden Einschränkungen gelten: Das Array kann höchstens 10 Elemente aufweisen. Der Textwert eines Arrayelements darf 1.000 Zeichen einschließlich Leerzeichen nicht überschreiten. Der gesamte text, der in der Anforderung enthalten ist, darf 5.000 Zeichen einschließlich Leerzeichen nicht überschreiten. 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– Eine Zeichenfolge, die das Ergebnis der Konvertierung der Eingabezeichenfolge in das Ausgabeskript ist. script– Eine Zeichenfolge, die das in der Ausgabe verwendete Skript angibt.

Antworten

Name	Typ	Beschreibung
200 OK	TransliterateResult[]	Erfolg
Other Status Codes	ErrorMessage	Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Ocp-Apim-Subscription-Region

Typ: apiKey
In: header

Beispiele

Transliterate success example

Beispielanforderung

HTTP

POST https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=jpan&toScript=latn

Beispiel für eine Antwort

Statuscode:

200

[
  {
    "text": "sodeska",
    "script": "latn"
  }
]

Definitionen

Name	Beschreibung
Error
ErrorMessage
TransliterateResult	Beispiel für eine erfolgreiche transliterate Anforderung
TransliterateTextInput	Text, der für eine transliterate Anforderung erforderlich ist

Error

Objekt

Name	Typ	Beschreibung
code	string
message	string

ErrorMessage

Objekt

Name	Typ	Beschreibung
error	Error

TransliterateResult

Objekt

Beispiel für eine erfolgreiche transliterate Anforderung

Name	Typ	Beschreibung
script	string
text	string

TransliterateTextInput

Objekt

Text, der für eine transliterate Anforderung erforderlich ist

Name	Typ	Beschreibung
text	string