Penerjemah 3.0: Deteksi

Artikel
09/22/2023

Identifikasi bahasa dari sepotong teks.

URL Permintaan

Kirim permintaan POST ke:

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

LihatVirtual Network Dukungan untuk layanan Penerjemah yang dipilih konfigurasi dan dukungan titik akhir privat dan jaringan.

Parameter permintaan

Parameter permintaan yang diteruskan pada string kueri adalah:

Parameter kueri	Deskripsi
versi-api	Parameter wajib. Versi API yang diminta oleh klien. Nilai harus `3.0`.

Header permintaan meliputi:

Header	Deskripsi
Header autentikasi	Header permintaan yang diperlukan. Lihat opsi yang tersedia untuk autentikasi.
Jenis-Konten	Header permintaan yang diperlukan. Menentukan jenis konten payload. Nilai yang mungkin adalah: `application/json`.
Panjang-Konten	Header permintaan yang diperlukan. Panjang isi permintaan.
X-ClientTraceId	Opsional. GUID yang dibuat oleh klien untuk mengidentifikasi permintaan secara unik. Anda bisa menghilangkan header ini jika Anda menyertakan ID jejak dalam string kueri menggunakan parameter kueri bernama `ClientTraceId`.

Isi permintaan

Isi permintaan berupa array JSON. Setiap elemen larik adalah objek JSON dengan properti string bernama Text. Deteksi bahasa diterapkan pada nilai properti Text. Deteksi otomatis bahasa berfungsi lebih baik dengan teks input yang lebih panjang. Isi permintaan sampel terlihat seperti ini:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Batasan berikut berlaku:

Larik dapat memiliki paling banyak 100 elemen.
Seluruh teks yang disertakan dalam permintaan tidak boleh melebihi 50.000 karakter termasuk spasi.

Isi Respons

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

language: Kode bahasa yang terdeteksi.
score: Nilai float yang menunjukkan keyakinan pada hasil. Skor antara nol dan satu dan skor rendah menunjukkan keyakinan yang rendah.
isTranslationSupported: Nilai boolean yang benar jika bahasa yang terdeteksi adalah salah satu bahasa yang didukung untuk terjemahan teks.
isTransliterationSupported: Nilai boolean yang benar jika bahasa yang terdeteksi adalah salah satu bahasa yang didukung untuk transliterasi.
alternatives: Larik dari kemungkinan bahasa lain. Setiap elemen array adalah objek lain dengan properti berikut: language, , scoreisTranslationSupported dan isTransliterationSupported.

Contoh respons JSON adalah:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Header respons

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

Kode status respons

Berikut ini adalah kemungkinan kode status HTTP yang dihasilkan oleh permintaan.

Kode Status	Deskripsi
200	Berhasil.
400	Salah satu parameter kueri tidak valid atau tidak ditemukan. Perbaiki parameter permintaan sebelum mencoba lagi.
401	Permintaan tidak dapat diautentikasi. Pastikan bahwa kredensial telah ditentukan dan valid.
403	Permintaan tersebut tidak diotorisasi. Periksa detail pesan kesalahan. Kode ini sering menunjukkan bahwa semua terjemahan gratis yang disediakan dengan langganan uji coba telah habis.
429	Server menolak permintaan karena klien telah melampaui batas permintaan.
500	Terjadi kesalahan tak terduga. Jika kesalahan berlanjut, laporkan dengan: tanggal dan waktu kegagalan, pengidentifikasi permintaan dari header respons `X-RequestId`, dan pengidentifikasi klien dari header permintaan `X-ClientTraceId`.
503	Server tidak tersedia untuk sementara. Coba lagi permintaannya. Jika kesalahan berlanjut, laporkan dengan: tanggal dan waktu kegagalan, pengidentifikasi permintaan dari header respons `X-RequestId`, dan pengidentifikasi klien dari header permintaan `X-ClientTraceId`.

Jika terjadi kesalahan, permintaan mengembalikan respons kesalahan JSON. Kode galat adalah nomor 6 digit yang menggabungkan kode status HTTP 3 digit diikuti dengan nomor 3 digit untuk mengategorikan kesalahan lebih lanjut. Kode galat umum dapat ditemukan di halaman referensi Penerjemah v3.

Contoh

Contoh berikut menunjukkan cara mengambil bahasa yang didukung untuk terjemahan teks.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"

Bagikan melalui