Translator 3.0: BreakSentence

Artikel
09/22/2023

Mengidentifikasi posisi batas kalimat dalam sepotong teks.

URL Permintaan

Kirim permintaan POST ke:

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

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

Parameter permintaan

Parameter permintaan yang diteruskan pada string kueri adalah:

Parameter Kueri	Deskripsi
api-version	Parameter kueri yang diperlukan. Versi API yang diminta oleh klien. Nilai harus `3.0`.
bahasa	Parameter kueri opsional. Tag bahasa yang mengidentifikasi bahasa teks input. Jika kode tidak ditentukan, deteksi bahasa otomatis diterapkan.
skrip	Parameter kueri opsional. Tag skrip yang mengidentifikasi skrip yang digunakan oleh teks input. Jika skrip tidak ditentukan, skrip default bahasa diasumsikan.

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 array adalah objek JSON dengan properti string bernama Text. Batas kalimat dihitung untuk nilai properti Text. Contoh isi permintaan dengan satu bagian teks terlihat seperti itu:

[
    { "Text": "How are you? I am fine. What did you do today?" }
]

Batasan berikut berlaku:

Larik dapat memiliki paling banyak 100 elemen.
Nilai teks elemen array tidak boleh melebihi 50.000 karakter termasuk spasi.
Seluruh teks yang disertakan dalam permintaan tidak boleh melebihi 50.000 karakter termasuk spasi.
Jika parameter kueri language ditentukan, semua elemen array harus dalam bahasa yang sama. Jika tidak, deteksi otomatis bahasa diterapkan ke setiap elemen array secara independen.

Isi Respons

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

sentLen: Array bilangan bulat yang mewakili panjang kalimat dalam elemen teks. Panjang array adalah jumlah kalimat, dan nilainya adalah panjang setiap kalimat.
detectedLanguage: Objek yang menjelaskan bahasa yang terdeteksi melalui properti berikut:
- language: Kode bahasa yang terdeteksi.
- score: Nilai float yang menunjukkan keyakinan pada hasil. Skornya antara nol (0) dan satu (1,0). Skor rendah (<= 0,4) menunjukkan keyakinan yang rendah.

Properti detectedLanguage hanya ada di objek hasil saat deteksi otomatis bahasa diminta.

Contoh respons JSON adalah:

[
    {
        "detectedLanguage": {
            "language": "en",
            "score": 1.0
        },
        "sentLen": [
            13,
            11,
            22
        ]
    }
]

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 respons 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 mendapatkan batas kalimat untuk satu kalimat. Layanan secara otomatis mendeteksi bahasa kalimat.

curl -X POST "https://api.cognitive.microsofttranslator.com/breaksentence?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'How are you? I am fine. What did you do today?'}]"

Bagikan melalui