Translator - Transliterate

Usługa:

Azure AI Services

Wersja interfejsu API:

3.0

Konwertuje tekst języka w jednym skrycie na inny typ skryptu. Przykład — japoński skrypt "こんにちは" To samo słowo w skrypcie łacińskim "konnichiha"

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
Endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services
api-version	query	True	string	Wersja interfejsu API żądanego przez klienta. Wartość musi być równa 3,0.
fromScript	query	True	string	Określa skrypt używany przez tekst wejściowy. Wyszukaj obsługiwane języki przy użyciu zakresu transliteration , aby znaleźć skrypty wejściowe dostępne dla wybranego języka.
language	query	True	string	Określa język tekstu, który ma być konwertowany z jednego skryptu na inny. Możliwe języki są wymienione w transliteration zakresie uzyskanym przez wysłanie zapytania do usługi dotyczącej obsługiwanych języków.
toScript	query	True	string	Określa skrypt wyjściowy. Wyszukaj obsługiwane języki przy użyciu zakresu transliteration , aby znaleźć skrypty wyjściowe dostępne dla wybranej kombinacji języka wejściowego i skryptu wejściowego.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
X-ClientTraceId		string	Identyfikator GUID wygenerowany przez klienta w celu unikatowego zidentyfikowania żądania. Pamiętaj, że można pominąć ten nagłówek, jeśli w ciągu zapytania dołączysz identyfikator śledzenia przy użyciu parametru zapytania o nazwie ClientTraceId.

Treść żądania

Nazwa	Typ	Opis
texts	TransliterateTextInput[]	Treść żądania Treść żądania jest tablicą JSON. Każdy element tablicy jest obiektem JSON z właściwością ciągu o nazwie Text, która reprezentuje ciąg do konwersji. Obowiązują następujące ograniczenia: Tablica może zawierać co najwyżej 10 elementów. Wartość tekstowa elementu tablicy nie może przekraczać 1000 znaków, w tym spacji. Cały tekst zawarty w żądaniu nie może przekraczać 5000 znaków, w tym spacji. Treść odpowiedzi Pomyślna odpowiedź to tablica JSON z jednym wynikiem dla każdego elementu w tablicy wejściowej. Obiekt wynikowy zawiera następujące właściwości: text- Ciąg znaków, który jest wynikiem konwersji ciągu wejściowego na skrypt wyjściowy. script- Ciąg określający skrypt używany w danych wyjściowych.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TransliterateResult[]	Sukces
Other Status Codes	ErrorMessage	Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Ocp-Apim-Subscription-Region

Typ: apiKey
W: header

Przykłady

Transliterate success example

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

200

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

Definicje

Nazwa	Opis
Error
ErrorMessage
TransliterateResult	Przykład pomyślnego żądania transliterowania
TransliterateTextInput	Tekst wymagany do żądania transliterowania

Error

Objekt

Nazwa	Typ	Opis
code	string
message	string

ErrorMessage

Objekt

Nazwa	Typ	Opis
error	Error

TransliterateResult

Objekt

Przykład pomyślnego żądania transliterowania

Nazwa	Typ	Opis
script	string
text	string

TransliterateTextInput

Objekt

Tekst wymagany do żądania transliterowania

Nazwa	Typ	Opis
text	string