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

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

リアルタイムスピーチ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 が含まれる場合にのみ受信します
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接続を維持するために十分なオーディオアクティビティが送信されていません