ナビゲーションにスキップ

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

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

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

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

committed_transcript は、各セグメントの安定した最終イベントです。公開APIは、個別の final_transcript イベントを出力しません。

送信イベント

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

Scribe v3 Liveでは、セッションの最初の input_audio_chunk にキータームライブラリを含めることもできます。

受信イベント

イベント説明受信するタイミング
session_started接続を確認し、セッション設定を返しますWebSocket接続の確立直後
partial_transcript処理中のセグメントのリアルタイムな文字起こし更新です。後から届く部分文字起こしが以前のものを置き換えます。diarize=true の場合、speaker_id を持つ下書きの words が含まれます(話者が特定されるまでは null)。話者IDとタイムスタンプは変更される場合があり、アラインメントされていない単語にはタイムスタンプがありません。キープアライブとしても送信されます。セグメントに未コミットのテキストがない場合は空の text、ある場合は最新の部分文字起こしの再送ですオーディオ処理中、コミット前。設定されている場合は、約 keepalive_interval_ms ごとにキープアライブとしても送信されます
committed_transcriptセグメントの確定済み文字起こしです。セグメントの安定した最終テキストであり、以後変更されません。diarize=true の場合、0から始まる segment_index が含まれ、話者分離による遅延はありませんコミット後(手動またはVADによるトリガー)
diarized_transcriptコミット済み文字起こしと一致する segment_index、text、words を含む、話者ラベル付きの文字起こしです。未特定の話者は speaker_id: null になります。話者分離を参照してください各コミット済み文字起こしの後に、コミット順で受信します。話者を特定できない場合も送信されます。diarize=true の場合のみ受信します
speakers_mergedfrom_speaker_id と to_speaker_id が同一人物を指すことを示します。以前の部分文字起こしと話者分離済み文字起こしに含まれるすべての from_speaker_id を to_speaker_id に置き換えてください。連続する統合は受信順に適用します。IDが再利用されることはありません2つの話者IDが同一人物と特定されたとき。diarize=true の場合のみ受信します
committed_transcript_with_timestamps単語単位のタイムスタンプと、検出された language_code を含むコミット済み文字起こしですコミット済み文字起こしの後に送信されます。クエリパラメーターに include_timestamps=true または include_language_detection=true が含まれる場合のみ受信します
committed_transcript_entitiesコミット済み文字起こしセグメントで検出されたエンティティと、その文字オフセットです各コミット済み文字起こしの直後に送信されます。クエリパラメーターに entity_detection が含まれる場合のみ受信します
redacted_transcript編集対象のエンティティをマーカーに置き換えたコミット済み文字起こしセグメントと、元のコミット済みテキストです各コミット済み文字起こしの直後に送信されます。クエリパラメーターに entity_redaction が含まれる場合のみ受信します
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接続を維持するために必要なオーディオアクティビティが送信されていません