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

なし

認証ヘッダーが無効または不足している場合にスローされます。