リクエストの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

なし

認証ヘッダーが無効または欠落している場合に発生します。