チャプター

チャプターノードは、ポッドキャストやインタビューの収録のチャプターを 1 回で一覧にします。収録を文字起こしして、タイトルと開始時刻付きのチャプターを見つけます。概要欄や動画の説明にそのまま貼り付けられます。レンダリングは行わず、結果はテキストです。

内部では、手作業で接続できるのと同じ工程を実行します。話者ラベルと単語のタイミング付きの文字起こしと、チャプターモードの編集プランです。各工程はそれぞれ独立したジョブとして実行されるので、長い収録、キャンセル、失敗は、手作業で組んだワークフローと同じように扱われます。

チャプターノードは、計画の工程を Nodaro Cloud で実行します。セルフホスティング環境では、連携 › nodaro.ai から、または API キーで、環境を Nodaro Cloud に接続してください。接続がない場合、ノードは表示されず、実行は何かが始まる前に拒否されます。

使いどころ

• ポッドキャストのエピソードの概要欄にチャプターを付ける。
• 動画の説明欄にタイムスタンプを付ける。
• 長いインタビューや講義の目次を作る。
• チャプター一覧を JSON として、プレーヤー、Web サイト、ワークフローの後の工程に渡す。

すでに文字起こしがある場合は、チャプターモードの編集プランを直接使います。エピソードを引き締めることもしたい場合は、エピソードを引き締めるを使います。

クイックスタート

入力

3 時間より長い収録や、音声のない収録は、何かが課金される前に拒否されます。複数の収録を接続した場合、実行では最初の 1 本を読み込みます。

出力

概要欄テキストの書き方：

• 最初のチャプターは 0:00 から始まります。 リスナーのプレーヤーが再生を始める位置です。
• 時間は必要なときだけ表示されます。 1:00:00 以降に始まるチャプターがあると、すべての行が時間付きになります：0:00:00 Intro、1:04:10 Questions。最後のチャプターが 58:00 に始まる 70 分のエピソードは、短い形のままです。
• 時刻は必ず増えていきます。 2 つのチャプターが同じ秒に始まる場合、最初のものだけが残り、ほかは除かれます。最初の 1 秒以内に始まるチャプターも除かれます。
• タイトルは 1 行です。 タイトル内の改行や連続した空白は、1 つの空白になります。

公開したアプリでは、概要欄テキストがテキストとして表示されます。

設定

実行が失敗した場合

完了した工程は完了したままです。文字起こしは保持され、再び課金されることはありません。ノードの続行を押すと、失敗した工程とそのあとの工程だけが再実行されます。

リストから入力されるノードは、項目ごとに 1 回実行されます。続行ボタンはないため、代わりにもう一度実行してください。

プランがチャプターを見つけられなかった場合、実行は「The plan found no chapters in this recording.」（この収録ではチャプターが見つかりませんでした）というメッセージで失敗します。実行ごとの手数料は返還されます。文字起こしとプランは実行されたので、それぞれの料金で課金されます。すべての工程が完了しているため、この実行は続行できず、ノードに続行は表示されません。別の指示か別の収録で、ノードをもう一度実行してください。

クレジット

チャプターノードは、各工程を、その工程にあたるノードと同じそれぞれの料金で課金し、さらに 1 回の実行ごとに少額の手数料がかかります。ノードは実行前に、手数料を含む見積もり全体を表示します。

• 実行ごとの手数料は、1 回の実行につき 1 回課金されます。失敗した実行の手数料は返還され、続行でまた確保されます。
• リストは各項目を別々の実行として処理し、 それぞれに手数料がかかります。
• 見積もりは、編集プランと同じ方法で収録の分数を数えます。長さがわからない収録は、上限の 180 分で見積もられます。編集プランの分数の数え方は、編集プランで説明しています。

ヒント

• チャプターの数を指定する。 指示で、チャプターの数とタイトルのスタイルを伝えます。例：titles under six words（タイトルは 6 語未満）。
• 出力を使い分ける。 概要欄テキストはテキスト欄や投稿の工程に接続します。開始時刻を数値として使いたい場合は、チャプター（JSON）を接続します。
• まずはエコノミーで。 デフォルトはエコノミーです。チャプターをもっと正確にしたいときは、より高い計画の品質を試してください。

トラブルシューティング

API から

POST /v1/episode-chapters は実行を開始し、jobId と executionId を付けて 202 を返します。本文には mediaUrls（収録の URL 1 つ）を指定し、任意で planTier、instructions、styleGuide を指定します。ジョブは GET /v1/jobs/:id/status でポーリングします。

• ジョブの output_data には、概要欄テキスト（text）、チャプター一覧（json）、編集プランが作ったままのプラン（plan）、文字起こし（transcript）が入ります。失敗した実行は完了した部分を保持し、失敗した工程を failedStep で示します。
• Idempotency-Key ヘッダーを付けると、同じリクエストを再試行したときに同じ jobId と "deduped": true が返り、何も開始されません。
• POST /v1/episode-chapters/estimate は同じ本文を受け取り、何も開始せずに { data: { totalCredits, stepsCredits, feeCredits, durationSec } } を返します。
• POST /v1/episode-chapters/continue に { jobId, "mode": "from-failed" } を渡すと、失敗した実行で完了しなかった部分を実行します。すべての工程が完了した実行には 409 continuation_not_failed が返ります。チャプターノードはレンダリングを行わないため、"mode": "render-final" には render_final_not_preview が返ります。

SDK（client.edit.episodeChapters、client.edit.estimateEpisodeChapters、client.edit.continueUseCase）、CLI（nodaro edit episode-chapters、見積もりには --estimate、および nodaro edit continue-use-case）、MCP の make_chapters、estimate_use_case、continue_use_case ツールは、同じルートを呼び出します。単一ノードの実行、SDK での編集、MCP の分析と EDL のツールを参照してください。