Sdílet prostřednictvím


Kontejner: Transkripce textu

Převeďte znaky nebo písmena zdrojového jazyka na odpovídající znaky nebo písmena cílového jazyka.

Adresa URL požadavku

POST prosba:

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

Viz Podpora virtuální sítě pro vybranou službu Translator a konfiguraci a podporu privátního koncového bodu.

Parametry požadavku

Parametry požadavku předané v řetězci dotazu jsou:

Parametr dotazu Popis Podmínka
verze-api Verze rozhraní API požadovaného klientem Hodnota musí být 3.0. Povinný parametr
jazyk Určuje zdrojový jazyk textu, který se má převést z jednoho skriptu na jiný. Povinný parametr
fromScript Určuje skript používaný vstupním textem. Povinný parametr
toScript Určuje výstupní skript. Povinný parametr

Záhlaví žádosti

Hlavičky Popis Podmínka
Hlavičky ověřování Zobrazit dostupné možnosti ověřování Požadovaná hlavička požadavku
Typ obsahu Určuje typ obsahu datové části. Možná hodnota: application/json Požadovaná hlavička požadavku
Délka obsahu Délka textu požadavku. Volitelné
X-ClientTraceId Identifikátor GUID vygenerovaný klientem pro jedinečnou identifikaci požadavku. Tuto hlavičku můžete vynechat, pokud do řetězce dotazu zahrnete ID trasování pomocí parametru dotazu s názvem ClientTraceId. Volitelné

Text 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 na výstupní skript.

  • script: Řetězec určující skript použitý ve výstupu.

Hlavičky odpovědi

Hlavičky Popis
X-RequestId Hodnota vygenerovaná službou pro identifikaci požadavku Dá se použít pro účely řešení potíží.

Ukázkový požadavek

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

Ukázkový text 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.

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

Platí následující omezení:

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

Ukázková odpověď JSON:

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

Poznámka:

  • Každá ukázka se spustí na localhost zadaném docker run příkazu.
  • Zatímco je kontejner spuštěný, localhost odkazuje na samotný kontejner.
  • Nemusíte používat localhost:5000. V hostitelském prostředí můžete použít libovolný port, který se ještě nepoužívá.

Transkripce s využitím rozhraní 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':'さようなら'}]"

Další kroky