Bagikan melalui


Kontainer: Transliterasi Teks

Mengonversi karakter atau huruf bahasa sumber ke karakter atau huruf terkait dari bahasa target.

URL Permintaan

POST Permintaan:

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

LihatDukungan Virtual Network untuk layanan Penerjemah jaringan yang dipilih dan konfigurasi dan dukungan titik akhir privat.

Parameter permintaan

Parameter permintaan yang diteruskan pada untai kueri adalah:

Parameter kueri Deskripsi Kondisi
versi-api Versi API yang diminta oleh klien. Nilai harus 3.0. Parameter yang diperlukan
bahasa Menentukan bahasa sumber teks yang akan dikonversi dari satu skrip ke skrip lainnya. Parameter yang diperlukan
fromScript Menentukan skrip yang digunakan oleh teks input. Parameter yang diperlukan
toScript Menentukan skrip output. Parameter yang diperlukan

Header permintaan

Header Deskripsi Kondisi
Header autentikasi Lihatopsi yang tersedia untuk autentikasi Header permintaan yang diperlukan
Content-Type Tentukan jenis konten payload. Nilai yang mungkin: application/json Header permintaan yang diperlukan
Panjang-Konten Panjang isi permintaan. Opsional
X-ClientTraceId GUID yang dihasilkan klien untuk mengidentifikasi permintaan secara unik. Anda bisa menghilangkan header ini jika Anda menyertakan ID jejak dalam string kueri menggunakan parameter kueri bernama ClientTraceId. Opsional

Isi respons

Respons yang berhasil adalah array JSON dengan satu hasil untuk setiap elemen dalam array input. Objek hasil mencakup properti berikut:

  • text: String yang dihasilkan dari mengonversi string input ke skrip output.

  • script: String yang menentukan skrip yang digunakan dalam output.

Header respons

Header Deskripsi
X-RequestId Nilai yang dihasilkan oleh layanan untuk mengidentifikasi permintaan. Ini dapat digunakan untuk tujuan pemecahan masalah.

Permintaan sampel

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

Isi permintaan sampel

Isi permintaan berupa array JSON. Setiap elemen array adalah objek JSON dengan properti string bernama Text, yang mewakili string yang akan dikonversi.

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

Batasan berikut berlaku:

  • Array dapat memiliki maksimum 10 elemen.
  • Nilai teks elemen array tidak boleh melebihi 1.000 karakter termasuk spasi.
  • Seluruh teks yang disertakan dalam permintaan tidak boleh melebihi 5.000 karakter termasuk spasi.

Sampel respons JSON:

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

Catatan

  • Setiap sampel berjalan pada localhost yang Anda tentukan dengan docker run perintah .
  • Saat kontainer Anda berjalan, localhost arahkan ke kontainer itu sendiri.
  • Anda tidak perlu menggunakan localhost:5000. Anda dapat menggunakan port apa pun yang belum digunakan di lingkungan host Anda.

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

Langkah berikutnya