リアルタイムイベントリファレンス

リアルタイムスピーチtoテキストAPIから受信するイベントのリファレンス

リファレンス · リアルタイムスピーチtoテキストWebSocket APIとの間で送受信されるすべてのイベントを一覧で示します。

APIとそのオプションの詳細については、リアルタイムスピーチtoテキストAPIのAPIリファレンスを確認してください。

committed_transcriptは、各セグメントの安定した最終イベントです。パブリックAPIでは、個別のfinal_transcriptイベントは出力されません。

送信イベント

イベント説明使用タイミング
input_audio_chunk文字起こし用の音声データを送信音声のストリーミング中に継続的に送信

受信イベント

イベント説明受信タイミング
session_started接続を確認し、セッション設定を返すWebSocket接続が確立された直後
partial_transcript処理中セグメントのライブ文字起こし更新。後続の部分結果は以前の結果を置き換えます音声処理中、コミットが行われる前
committed_transcriptセグメントの確定済み文字起こし。これはセグメントの安定した最終テキストであり、変更されませんコミット後(手動またはVADによるトリガー)
committed_transcript_with_timestamps単語レベルのタイムスタンプと検出されたlanguage_codeを含むコミット済み文字起こしコミット済み文字起こしの後に送信。クエリパラメータにinclude_timestamps=trueまたはinclude_language_detection=trueが含まれる場合にのみ受信
committed_transcript_entities文字オフセットを含む、コミット済み文字起こしセグメントで検出されたエンティティ各コミット済み文字起こしの直後に送信。クエリパラメータにentity_detectionが含まれる場合にのみ受信
edited_transcript元のコミット済みテキストとともに送信される、コミット済み文字起こしセグメントの編集版各コミット済み文字起こしの直後に送信。クエリパラメータにtranscript_editが含まれる場合にのみ受信

エラー処理

エラーが発生した場合、WebSocket接続が閉じられる前にエラーメッセージが返されます。

エラータイプ説明
auth_errorリクエストの認証中にエラーが発生しました。APIキーを再確認してください
quota_exceeded使用量上限を超えています
transcriber_error音声の文字起こし中にエラーが発生しました。
input_error音声チャンクの処理中にエラーが発生しました。入力形式またはパラメータが無効である可能性があります
invalid_request接続パラメータが拒否されました。クエリパラメータをAPIリファレンスと照合してください
error一般的なサーバーエラー
commit_throttled短時間にコミットリクエストを多く送信したため、コミットがスロットリングされました
unaccepted_termsScribeを使用するための利用規約に同意していません。ElevenLabsダッシュボードで利用規約を確認し、同意してください
rate_limitedレート制限が適用されています。短時間に送信するリクエスト数を減らしてください
queue_overflow処理キューがいっぱいです。短時間に送信するリクエスト数を減らしてください
resource_exhaustedサーバーリソースが上限に達しています。後でもう一度お試しください
session_time_limit_exceededセッションの最大時間に達しました。新しいセッションを開始するか、サブスクリプションをアップグレードしてください
chunk_size_exceeded音声チャンクサイズが大きすぎます。チャンクサイズを小さくしてください
insufficient_audio_activity接続を維持するために十分な音声アクティビティが送信されていません