Udostępnij za pośrednictwem

Kontener: transliteracja tekstu

  • Artykuł

Konwertuj znaki lub litery języka źródłowego na odpowiadające im znaki lub litery języka docelowego.

Adres URL żądania

POST prosić:

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

Zobacz Obsługa sieci wirtualnej dla wybranej sieci translator i konfiguracji prywatnego punktu końcowego oraz obsługi.

Parametry żądania

Parametry żądania przekazane w ciągu zapytania to:

Parametr zapytania opis Warunek
api-version Wersja interfejsu API żądanego przez klienta. Wartość musi mieć wartość 3.0. Wymagany parametr
język Określa język źródłowy tekstu, który ma być konwertowany z jednego skryptu na inny. Wymagany parametr
fromScript Określa skrypt używany przez tekst wejściowy. Wymagany parametr
toScript Określa skrypt wyjściowy. Wymagany parametr

Nagłówki żądań

Nagłówki opis Warunek
Nagłówki uwierzytelniania Zobacz dostępne opcje uwierzytelniania Wymagany nagłówek żądania
Typ zawartości Określa typ zawartości ładunku. Możliwa wartość: application/json Wymagany nagłówek żądania
Długość zawartości Długość treści żądania. Opcjonalne
X-ClientTraceId Identyfikator GUID wygenerowany przez klienta w celu unikatowego zidentyfikowania żądania. Ten nagłówek można pominąć, jeśli dołączysz identyfikator śledzenia w ciągu zapytania przy użyciu parametru zapytania o nazwie ClientTraceId. Opcjonalne

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, który wynika z konwertowania ciągu wejściowego na skrypt wyjściowy.

  • script: ciąg określający skrypt używany w danych wyjściowych.

Nagłówki odpowiedzi

Nagłówki opis
X-RequestId Wartość wygenerowana przez usługę w celu zidentyfikowania żądania. Może służyć do rozwiązywania problemów.

Przykładowe żądanie

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

Przykładowa 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.

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

Obowiązują następujące ograniczenia:

  • Tablica może zawierać maksymalnie 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.

Przykładowa odpowiedź JSON:

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

Uwaga

  • Każdy przykład jest uruchamiany w localhost określonym poleceniu docker run .
  • Gdy kontener jest uruchomiony, localhost wskazuje sam kontener.
  • Nie musisz używać polecenia localhost:5000. Możesz użyć dowolnego portu, który nie jest jeszcze używany w środowisku hosta.

Transliteracja za pomocą interfejsu API REST


  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':'さようなら'}]"

Następne kroki

Dowiedz się więcej o transliteracji tekstu