ELSA SpeakELSA Speak

Daftar Error API untuk Permintaan

Updated June 16, 2026·35 views

Automatically translated. View the original in English.

Daftar Error API untuk Permintaan

Halaman ini memberikan gambaran menyeluruh tentang pesan pengecualian yang mungkin dikembalikan oleh layanan. Pesan pengecualian ini dikategorikan berdasarkan jenis permintaan atau operasi, memberikan wawasan terperinci tentang potensi masalah yang ditemui selama penggunaan layanan, seperti Permintaan Tanpa Skrip, Permintaan Berskrip, serta error Autentikasi atau Pemrosesan Audio tertentu.

Setiap error tercantum dengan:

  • Nama: Nama pengecualian.
  • Pesan: Pesan error terperinci yang dikembalikan oleh sistem.
  • Parameter: Informasi atau konteks tambahan apa pun yang diperlukan untuk error tersebut.
  • Deskripsi: Penjelasan singkat tentang kapan dan mengapa error terjadi.

Gunakan daftar ini sebagai referensi untuk memahami, men-debug, dan menangani potensi masalah saat berinteraksi dengan API secara efektif.

Permintaan Tanpa Skrip

Permintaan tanpa skrip melibatkan operasi real-time atau asinkron di mana API memproses input secara dinamis tanpa bergantung pada skrip atau alur kerja yang telah ditentukan sebelumnya. Permintaan ini sering digunakan untuk skenario seperti pemrosesan audio langsung, tugas ASR (Automatic Speech Recognition) ad-hoc, atau interaksi dinamis lainnya.

Pengecualian ASR

Pengecualian

Pesan

Parameter

Deskripsi

ASRInterProcessException

exception in ASR: {error}

error (str): Detail error.

Muncul ketika terjadi pengecualian antar-proses dalam sistem ASR.

ASRSocketTimeout

ASR timeout

None

Muncul ketika sistem ASR mengalami waktu habis saat memproses.

ASRConnectionFailed

ASR Connection Failed

None

Muncul ketika koneksi ke sistem ASR gagal.

Pengecualian Audio

Pengecualian

Pesan

Parameter

Deskripsi

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Muncul ketika server tidak dapat membaca audio dari URL yang diberikan.

FailedToParseAudioHeader

Failed to parse audio header

None

Muncul ketika header audio tidak dapat diurai.

InvalidAudioFormat

Only 16 kHz mono WAV, FLAC or OGG-Opus audio allowed

None

Muncul ketika format audio yang diberikan tidak valid.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): Format audio yang gagal dikonversi.

Muncul ketika server gagal mengonversi format audio yang diberikan.

FailedToDecodeAudioFromBytes

Failed to decode audio

None

Muncul ketika server gagal mendekode data audio dari bytes.

MissingAudioParam

Missing audio param!

None

Muncul ketika parameter audio yang diperlukan tidak ada.

AudioTooBigForSync

Audio is too big for sync mode, please change to async mode

stream_dir (str): Direktori atau lokasi aliran audio.

Muncul ketika audio yang diberikan terlalu besar untuk pemrosesan sinkron.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Muncul ketika terjadi error tak terduga saat memproses audio.

Pengecualian Autentikasi

Pengecualian

Pesan

Parameter

Deskripsi

NoTokenProvided

No session token provided

None

Muncul ketika tidak ada token sesi yang diberikan.

InvalidSessionToken

Invalid session token: {token}

token (str): Token sesi yang tidak valid.

Muncul ketika token sesi yang tidak valid diberikan.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): Jenis ID pengguna.

Muncul ketika pengguna yang ditentukan tidak ada.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): ID pengguna.

Muncul ketika klien yang ditentukan tidak aktif.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): ID pengguna.

Muncul ketika klien yang ditentukan tidak memiliki akses ke API.

ClientHasNoMoreMinutes

User has no remaining minutes

None

Muncul ketika pengguna tidak memiliki menit tersisa untuk penggunaan API.

Permintaan Berskrip

Permintaan berskrip melibatkan alur kerja atau operasi yang telah ditentukan sebelumnya yang mengikuti urutan atau skrip tertentu. Permintaan ini umumnya digunakan dalam skenario di mana input dan output yang diharapkan sudah terdefinisi dengan baik, seperti memproses audio berdasarkan skrip yang telah ditentukan, menjalankan tugas otomatis, atau menangani alur kerja terstruktur.

Pengecualian Audio

Pengecualian

Pesan

Parameter

Deskripsi

MissingAudioParam

Missing audio param!

None

Muncul ketika parameter audio yang diperlukan tidak ada.

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Muncul ketika server tidak dapat membaca audio dari URL yang diberikan.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): Format audio yang gagal dikonversi.

Muncul ketika server gagal mengonversi format audio yang diberikan.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Muncul ketika terjadi error tak terduga saat memproses audio.

Pengecualian Autentikasi

Pengecualian

Pesan

Parameter

Deskripsi

NoTokenProvided

No session token provided

None

Muncul ketika tidak ada token sesi yang diberikan.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): ID pengguna.

Muncul ketika klien yang ditentukan tidak aktif.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): ID pengguna.

Muncul ketika klien yang ditentukan tidak memiliki akses ke API.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): Jenis ID pengguna.

Muncul ketika pengguna yang ditentukan tidak ada.

InvalidHeaderParameter

A valid authorization header is required

None

Muncul ketika header otorisasi tidak valid atau tidak ada.

Was this article helpful?

Or open the chat in the corner to ask follow-up questions.