文字起こしの編集

既存の文字起こしを発言単位で取得し、本文だけを一括修正できます。番組オーナー権限と、取得にはAPIトークンの read、更新・プレビューには update が必要です。リクエストには Authorization: Bearer $LISTEN_API_TOKEN を指定してください。

発言を取得する

GET /api/v1/episodes/{episode}/transcript/segments?start=12&end=40&limit=50

{episode} はエピソードIDです。start と end は秒数で、省略すると時間で絞り込みません。範囲と重なる発言を返します。limit は既定50・最大200件です。続きは同じ条件で next_offset を offset に渡してください。ページ間で version が変わった場合は、最初から取得し直してください。

{"data":{"episode_id":"EPISODE_ID","version":"VERSION","segment_count":15,"unassigned_count":2,"next_offset":null,"segments":[{"index":4,"start":12.3,"end":15.4,"text":"修正前の本文","speaker":0,"starring_id":123,"speaker_name":"出演者名"}]}}

segment_count と unassigned_count は文字起こし全体の件数です。speaker が null なら話者未設定、starring_id が null なら出演者への紐づけがありません。発言の index はそのバージョン内で有効な番号です。

本文を更新する

PATCH /api/v1/episodes/{episode}/transcript/segments に Content-Type: application/json で送信します。

{"version":"VERSION","edits":[{"index":4,"text":"修正後の本文"}],"dry_run":true}

取得結果の version をそのまま使ってください。一度に最大200件、1件あたり4,000文字までです。同じ発言番号の重複や存在しない番号があれば、全件を拒否します。dry_run: true は保存せずに差分を返します。保存する場合は省略するか false を渡してください。

{"data":{"episode_id":"EPISODE_ID","version":"VERSION","dry_run":true,"changed_count":1,"changes":[{"index":4,"before":"修正前の本文","after":"修正後の本文"}]}}

開始・終了時刻、話者、出演者の紐づけ、チャプター、要約は保持します。単語時刻の原データも保持します。本文が元の単語列と一致しなくなった発言は、編集画面で発言単位の時刻表示に切り替わります。保存後に戻す場合は、更新結果の version と、各 changes[].before を本文とする差分を送ります。変更履歴の保存は行いません。

401 は未認証、403 は権限不足、404 は対象のエピソードや文字起こしがない場合、422 は入力エラー、429 は回数制限です。409 は取得後に文字起こしが変わったか、文字起こし・話者分離が実行中です。最新の発言を再取得し、差分を確認してからやり直してください。