Contoh penggunaan API

Permintaan Berskrip​

Berikut adalah beberapa contoh yang menunjukkan penggunaan API berskrip.

Endpoint Score_audio​

Demo ini akan dilakukan di baris perintah menggunakan sistem yang kompatibel dengan Linux melalui perintah cURL.

Perintah cURL menggunakan parameter audio_path​

Dalam contoh ini, kita akan menggunakan kalimat "When the sunlight strikes raindrops in the air, they act like a prism and form a rainbow." dengan audio yang tersedia di URL publik ini [https://elsa-api-docs.s3-eu-west-1.amazonaws.com/api\_samples/rainbow.wav]{{LINK0}}

curl -XPOST -s https://api.elsanow.io/api/v2/score_audio -F "api_plan=premium" -F "audio_path=https://elsa-api-docs.s3-eu-west-1.amazonaws.com/api_samples/rainbow.wav" -F sentence="When the sunlight strikes raindrops in the air, they act like a prism and form a rainbow" --header "Authorization: ELSA <API_token>"

Perintah cURL menggunakan parameter audio_file​

curl -XPOST -s https://api.elsanow.io/api/v2/score_audio -F "api_plan=premium" -F "audio_file=@<path_to_the_file>/rainbow.wav" -F sentence="When the sunlight strikes raindrops in the air, they act like a prism and form a rainbow" --header "Authorization: ELSA <API_token>"

Anda dapat mengubah parameter "api_plan" untuk mendapatkan hasil yang lebih atau kurang terperinci.

Contoh dukungan Pilihan Ganda​

Menggunakan endpoint dan parameter yang sama seperti di atas, kita juga dapat menilai latihan pilihan ganda, di mana mesin ELSA akan: 1) memilih kata/kalimat yang paling sesuai dengan masukan pengguna; b) menilai kalimat tersebut seperti pada kasus kalimat tunggal. Untuk melakukan pilihan ganda, kita akan mengirimkan daftar kalimat yang mungkin di bidang sentence:

sentence: ["sentence 0", "sentence 1"]

Tidak ada batasan jumlah kalimat yang dapat Anda kirim.

Berikut adalah cara untuk mengirim daftar dalam perintah curl:

sentence="[\"sentence 0\",\"sentence 1\"]"

Permintaan Tidak Berskrip​

Berikut adalah beberapa contoh penggunaan API tidak berskrip.

Endpoint Score_audio_plus​

Untuk mengimplementasikan panggilan ke ELSA API, kita dapat menggunakan perintah "curl" di baris perintah apa pun yang kompatibel dengan Linux.

Perintah cURL menggunakan parameter audio_file​

Sampel berikut akan mengembalikan tautan untuk mengunduh hasil json saat dipanggil menggunakan file audio lokal (jangan lupa tambahkan "@" sebelum path).

curl -XPOST -s https://api.elsanow.io/api/v1/score_audio_plus -F "api_plan=premium" -F "audio_file=@<path_to_your_file.wav>" --header "Authorization: ELSA <API_token>"

Jika Anda lebih suka menerima json itu sendiri sebagai jawaban dari panggilan, lakukan:

 curl -XPOST -s https://api.elsanow.io/api/v1/score_audio_plus -F "api_plan=premium" -F "return_json=true" -F "audio_file=@<path_to_your_file.wav>" --header "Authorization: ELSA <API_token>"

Endpoint ASR​

Contoh penggunaan transkripsi ASR dan penyelarasan waktu tingkat kata:

curl -XPOST -s https://api.elsanow.io/api/v1/asr -F "audio=@<path_to_your_file.wav>" --header "Authorization: ELSA <API_token>"

Pengambilan fungsi secara asinkron​

Contoh penggunaan asinkron. Kita mulai dengan memanggil API menggunakan file audio dan mengambil stream_id darinya.

curl -XPOST -s https://api.elsanow.io/api/v1/score_audio_plus -F "api_plan=premium" -F "audio_file=@<path_to_your_file.wav>" --header "Authorization: ELSA <API_token>" -F "sync=false" 

Berikut adalah contoh hasilnya:

{"stream_id":"<unique_stream_id>"}

Endpoint Result​

Untuk mengambil file hasil (baik sebagai tautan unduhan maupun sebagai struktur json), panggil endpoint result.

Ambil satu hasil, dapatkan tautan unduhan:​

curl -XGET "https://api.elsanow.io/result?stream_id=<unique_stream_id>" --header "Authorization: ELSA <API_token>"

Ambil satu hasil dengan format json​

Ambil satu hasil:

curl -XGET "https://api.elsanow.io/result?stream_id=<unique_stream_id>&return_json=true" --header "Authorization: ELSA <API_token>"

Ambil beberapa hasil sekaligus (pada opsi ini, kami tidak mengizinkan pengembalian json dalam panggilan)

curl -XGET "https://api.elsanow.io/result?stream_id=<unique_stream_id>&stream_id=<unique_stream_id>" --header "Authorization: ELSA <API_token>"

Endpoint Audio​

Untuk mengambil file audio:

curl -XGET "https://api.elsanow.io/audio?stream_id=<unique_stream_id>" --header "Authorization: ELSA <API_token>"