Sdílet prostřednictvím


Translator - Transliterate

Převede text jazyka v jednom skriptu na jiný typ skriptu. Příklad - japonské písmo "こんにちは" Stejné slovo v latince "konnichiha"

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
Endpoint
path True

string

Podporované koncové body služeb Cognitive Services

api-version
query True

string

Verze rozhraní API požadovaného klientem Hodnota musí být 3.0.

fromScript
query True

string

Určuje skript používaný vstupním textem. Vyhledávejte podporované jazyky pomocí transliteration oboru a vyhledejte vstupní skripty dostupné pro vybraný jazyk.

language
query True

string

Určuje jazyk textu, který se má převést z jednoho skriptu na jiný. Možné jazyky jsou uvedeny v transliteration rozsahu získaném dotazem na službu pro její podporované jazyky.

toScript
query True

string

Určuje výstupní skript. Vyhledávejte podporované jazyky pomocí transliteration rozsahu a vyhledejte výstupní skripty dostupné pro vybranou kombinaci vstupního jazyka a vstupního skriptu.

Hlavička požadavku

Name Vyžadováno Typ Description
X-ClientTraceId

string

Identifikátor GUID vygenerovaný klientem pro jedinečnou identifikaci požadavku. Všimněte si, že tuto hlavičku můžete vynechat, pokud do řetězce dotazu zahrnete ID trasování pomocí parametru dotazu s názvem ClientTraceId.

Text požadavku

Name Typ Description
texts

TransliterateTextInput[]

Obsah požadavku

Text požadavku je pole JSON. Každý prvek pole je objekt JSON s řetězcovou vlastností s názvem Text, která představuje řetězec pro převod. Platí následující omezení:

  • Pole může mít maximálně 10 prvků.
  • Textová hodnota prvku pole nesmí přesáhnout 1 000 znaků včetně mezer.
  • Celý text obsažený v žádosti nesmí přesáhnout 5 000 znaků včetně mezer.

Obsah odpovědi

Úspěšná odpověď je pole JSON s jedním výsledkem pro každý prvek vstupního pole. Výsledný objekt obsahuje následující vlastnosti:

  • text- Řetězec, který je výsledkem převodu vstupního řetězce do výstupního skriptu.
  • script- Řetězec určující skript použitý ve výstupu.

Odpovědi

Name Typ Description
200 OK

TransliterateResult[]

Úspěch

Other Status Codes

ErrorMessage

Chybová odpověď.

Zabezpečení

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

Ocp-Apim-Subscription-Region

Typ: apiKey
V: header

Příklady

Transliterate success example

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
Error
ErrorMessage
TransliterateResult

Příklad úspěšného požadavku na transliteraci

TransliterateTextInput

Text potřebný pro požadavek na transliteraci

Error

Name Typ Description
code

string

message

string

ErrorMessage

Name Typ Description
error

Error

TransliterateResult

Příklad úspěšného požadavku na transliteraci

Name Typ Description
script

string

text

string

TransliterateTextInput

Text potřebný pro požadavek na transliteraci

Name Typ Description
text

string