請求的 API 錯誤列表

本頁提供服務可能回傳之例外訊息的完整概覽。這些例外訊息依請求或操作類型分類，詳細說明在使用服務過程中可能遭遇的問題，例如非腳本化請求、腳本化請求，以及特定的驗證或音訊處理錯誤。

每個錯誤均列出以下資訊：

• 名稱：例外的名稱。
• 訊息：系統回傳的詳細錯誤訊息。
• 參數：錯誤所需的任何額外資訊或背景說明。
• 描述：簡要說明錯誤發生的時機與原因。

請將本列表作為參考，以便有效地理解、除錯並處理與 API 互動時可能發生的問題。

非腳本化請求​

非腳本化請求涉及即時或非同步操作，API 會動態處理輸入，而不依賴預先定義的腳本或工作流程。這類請求常用於即時音訊處理、臨時 ASR（自動語音辨識）任務或其他動態互動等情境。

ASR 例外​

例外

訊息

參數

描述

ASRInterProcessException

exception in ASR: {error}

error (str)：錯誤的詳細資訊。

當 ASR 系統發生跨程序例外時觸發。

ASRSocketTimeout

ASR timeout

無

當 ASR 系統在處理過程中逾時時觸發。

ASRConnectionFailed

ASR Connection Failed

無

當連線至 ASR 系統失敗時觸發。

音訊例外​

例外

訊息

參數

描述

FailedToReadAudioFromURL

Failed to read audio from the URL

無

當伺服器無法從提供的 URL 讀取音訊時觸發。

FailedToParseAudioHeader

Failed to parse audio header

無

當無法解析音訊標頭時觸發。

InvalidAudioFormat

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

無

當提供的音訊格式無效時觸發。

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str)：轉換失敗的音訊格式。

當伺服器無法轉換提供的音訊格式時觸發。

FailedToDecodeAudioFromBytes

Failed to decode audio

無

當伺服器無法從位元組解碼音訊資料時觸發。

MissingAudioParam

Missing audio param!

無

當必要的 audio 參數遺失時觸發。

AudioTooBigForSync

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

stream_dir (str)：音訊串流的目錄或位置。

當提供的音訊對同步處理而言過大時觸發。

FailedToUseAudio

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

無

當處理音訊時發生非預期錯誤時觸發。

驗證例外​

例外

訊息

參數

描述

NoTokenProvided

No session token provided

無

當未提供工作階段權杖時觸發。

InvalidSessionToken

Invalid session token: {token}

token (str)：無效的工作階段權杖。

當提供的工作階段權杖無效時觸發。

UserDoesNotExist

Could not find {user_type} ID

user_type (str)：使用者 ID 的類型。

當指定的使用者不存在時觸發。

ClientIsNotActive

Client with {user_id} is not active

user_id (str)：使用者 ID。

當指定的客戶端未啟用時觸發。

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str)：使用者 ID。

當指定的客戶端無權存取 API 時觸發。

ClientHasNoMoreMinutes

User has no remaining minutes

無

當使用者的 API 使用分鐘數已用盡時觸發。

腳本化請求​

腳本化請求涉及遵循特定順序或腳本的預先定義工作流程或操作。這類請求常用於輸入與預期輸出均已明確定義的情境，例如依據預定腳本處理音訊、執行自動化任務或處理結構化工作流程。

音訊例外​

例外

訊息

參數

描述

MissingAudioParam

Missing audio param!

無

當必要的 audio 參數遺失時觸發。

FailedToReadAudioFromURL

Failed to read audio from the URL

無

當伺服器無法從提供的 URL 讀取音訊時觸發。

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str)：轉換失敗的音訊格式。

當伺服器無法轉換提供的音訊格式時觸發。

FailedToUseAudio

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

無

當處理音訊時發生非預期錯誤時觸發。

驗證例外​

例外

訊息

參數

描述

NoTokenProvided

No session token provided

無

當未提供工作階段權杖時觸發。

ClientIsNotActive

Client with {user_id} is not active

user_id (str)：使用者 ID。

當指定的客戶端未啟用時觸發。

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str)：使用者 ID。

當指定的客戶端無權存取 API 時觸發。

UserDoesNotExist

Could not find {user_type} ID

user_type (str)：使用者 ID 的類型。

當指定的使用者不存在時觸發。

InvalidHeaderParameter

A valid authorization header is required

無

當授權標頭無效或遺失時觸發。