要約の管理

番組オーナーは、要約を取得・編集し、必要に応じて現在の文字起こしから再生成できます。文字起こしのアップロードだけでは、以前の要約は変わりません。

認証とリクエスト

Bearerトークンの read（取得）または update（編集・再生成）が必要です。URLの {episode} はエピソードIDです。

GET  /api/v1/episodes/{episode}/summary
PUT  /api/v1/episodes/{episode}/summary
POST /api/v1/episodes/{episode}/summary/regenerate

curl -X PUT "https://listen.style/api/v1/episodes/$EPISODE_ID/summary" \
  -H "Authorization: Bearer $LISTEN_API_TOKEN" \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -d '{"summary":"自分で作成した要約です。"}'

取得・編集は 200 と次のJSONを返します。summary: null で要約を消せます。文字起こしがまだない回では、先に文字起こしをアップロードしてください。

{"data":{"episode_id":"EPISODE_ID","summary":"自分で作成した要約です。"}}

再生成

POST /summary/regenerate に本文なしでリクエストすると、受付時は 202 と {"data":{"episode_id":"EPISODE_ID","status":"queued"}} を返します。完了後にGETで確認してください。受付は完了を意味しません。

現在の文字起こしから要約だけを作り直し、チャプター・本文・話者は維持します。番組の自動生成がオフでも、明示的な再生成依頼は利用できます。処理中に本文・話者付き字幕・要約が編集された場合、古い結果で上書きしません。必要なら最新版を確認して再度依頼してください。

利用条件とエラー

取得・手動編集は無料を含む全プラン。要約は20,000文字以内です。再生成は通常の要約生成と同じプラン・対象エピソード条件で、利用者・エピソードごとに1時間3回までです。API共通の毎分60回制限も適用されます。

401 未認証、403 オーナー・トークン権限不足や再生成のプラン条件外、404 対象なし、422 文字起こし未登録・入力不正、429 回数制限です。429 は Retry-After に従って再試行してください。検索への変更反映は非同期です。