Bagikan melalui


Translator - Transliterate

Mengonversi teks bahasa dalam satu skrip menjadi jenis skrip lain. Contoh- Aksara Jepang "こんにちは" Kata yang sama dalam aksara Latin "konnichiha"

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
Endpoint
path True

string

Titik akhir Cognitive Services yang didukung

api-version
query True

string

Versi API yang diminta oleh klien. Nilainya harus 3.0.

fromScript
query True

string

Menentukan skrip yang digunakan oleh teks input. Cari bahasa yang didukung menggunakan transliteration cakupan, untuk menemukan skrip input yang tersedia untuk bahasa yang dipilih.

language
query True

string

Menentukan bahasa teks yang akan dikonversi dari satu skrip ke skrip lainnya. Bahasa yang mungkin tercantum dalam cakupan transliteration yang diperoleh dengan mengkueri layanan untuk bahasa yang didukungnya.

toScript
query True

string

Menentukan skrip output. Cari bahasa yang didukung menggunakan transliteration cakupan, untuk menemukan skrip output yang tersedia untuk kombinasi bahasa input dan skrip input yang dipilih.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
X-ClientTraceId

string

GUID yang dihasilkan klien untuk mengidentifikasi permintaan secara unik. Perhatikan bahwa Anda dapat menghilangkan header ini jika Anda menyertakan ID pelacakan dalam string kueri menggunakan parameter kueri bernama ClientTraceId.

Isi Permintaan

Nama Jenis Deskripsi
texts

TransliterateTextInput[]

Isi dari permintaan

Isi permintaan adalah array JSON. Setiap elemen array adalah objek JSON dengan properti string bernama Text, yang mewakili string yang akan dikonversi. Batasan berikut berlaku:

  • Array dapat memiliki paling banyak 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.

Badan respons

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

  • text- String yang merupakan hasil dari konversi string input ke skrip output.
  • script- String yang menentukan skrip yang digunakan dalam output.

Respons

Nama Jenis Deskripsi
200 OK

TransliterateResult[]

Keberhasilan

Other Status Codes

ErrorMessage

Respons kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Jenis: apiKey
Dalam: header

Ocp-Apim-Subscription-Key

Jenis: apiKey
Dalam: header

Ocp-Apim-Subscription-Region

Jenis: apiKey
Dalam: header

Contoh

Transliterate success example

Permintaan sampel

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

Respon sampel

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

Definisi

Nama Deskripsi
Error
ErrorMessage
TransliterateResult

Contoh permintaan transliterasi yang berhasil

TransliterateTextInput

Teks yang diperlukan untuk permintaan transliterasi

Error

Nama Jenis Deskripsi
code

string

message

string

ErrorMessage

Nama Jenis Deskripsi
error

Error

TransliterateResult

Contoh permintaan transliterasi yang berhasil

Nama Jenis Deskripsi
script

string

text

string

TransliterateTextInput

Teks yang diperlukan untuk permintaan transliterasi

Nama Jenis Deskripsi
text

string