ナビゲーションにスキップ
ハウツーガイドスピーチtoテキストリアルタイム

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

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

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

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

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

送信イベント

イベント説明使用するタイミング
input_audio_chunk文字起こし用のオーディオデータを送信オーディオのストリーミング中は継続して送信

受信イベント

イベント説明受信タイミング
session_started接続を確認し、セッション設定を返すWebSocket接続が確立された直後
partial_transcript処理中のセグメントに対するライブ文字起こしの更新。後の部分文字起こしは、前のものを置き換えます。キープアライブとしても送信されます。セグメントに未コミットのテキストがない場合は text が空になり、ある場合は最新の部分文字起こしが繰り返されますオーディオ処理中、コミット前。設定されている場合は、keepalive_interval_ms ごとにキープアライブとしても送信されます
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接続を維持するために十分なオーディオアクティビティを送信していません