# チャプター

> チャプターノードは、ポッドキャストやインタビューのチャプターを、タイトルと開始時刻付きで 1 回で一覧にします。概要欄や動画の説明にそのまま貼り付けられます。

Source: https://nodaro.ai/ja/docs/nodes/video/episode-chapters

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

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

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

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

すでに文字起こしがある場合は、**チャプター**モードの[**編集プラン**](https://nodaro.ai/docs/nodes/video/edit-plan)を直接使います。エピソードを引き締めることもしたい場合は、[**エピソードを引き締める**](https://nodaro.ai/docs/nodes/video/tighten-episode)を使います。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**動画 › ポッドキャスト › チャプター**を選びます。このノードは**オーディオ**タブにも表示されます。

### 収録を接続する
エピソードを**録音**入力に接続します。たとえば[**オーディオアップロード**](https://nodaro.ai/docs/nodes/audio/upload-audio)ノードや[**動画アップロード**](https://nodaro.ai/docs/nodes/video/upload-video)ノードから接続します。収録は最長 3 時間までで、音声が入っている必要があります。

### プランに指示を出す
必要に応じて**指示**を書きます。例：`5 to 8 chapters, titles under six words`（チャプターは 5〜8 個、タイトルは 6 語未満）。

### 実行する
ノードの**実行**をクリックします。ノードにチャプター一覧と、それをコピーするボタンが表示されます。

Workflow: チャプターノードが収録したエピソードを文字起こしし、チャプター一覧を概要欄テキストと JSON で返します。

- オーディオアップロード → チャプター (録音)

## 入力
| 入力 | 受け付けるもの | 役割 |
| --- | --- | --- |
| **録音** | 動画またはオーディオ | エピソードの収録で、最長 3 時間です。音声が入っている必要があります。必須です。 |

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

## 出力
| 出力 | 内容 |
| --- | --- |
| **概要欄テキスト** | チャプター一覧のテキストで、チャプターごとに 1 行です。開始時刻のあとにタイトルが続きます。例：`0:00 Intro`、`12:47 Why we moved`。 |
| **チャプター（JSON）** | 同じチャプターを同じ順で並べた JSON です：`[{ "startMs": 0, "title": "Intro" }]`。各 `startMs` はミリ秒単位の開始時刻です。最初のチャプターは 0 から始まります。 |

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

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

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

## 設定
| 設定 | 役割 |
| --- | --- |
| **計画の品質** | **エコノミー**（デフォルト）、**スタンダード**、**プレミアム**のいずれかです。編集プランの工程のティアで、プランの品質と料金が決まります。 |
| **指示** | プランへの短い指示で、最大 4,000 文字です。例：`5 to 8 chapters`（チャプターは 5〜8 個）、`short titles`（短いタイトル）。 |
| **スタイルガイド** | プランへの、より長い編集方針で、最大 4,000 文字です。 |

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

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

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

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

| 工程 | 料金 |
| --- | --- |
| 文字起こし（ElevenLabs STT） | 1 回の実行につき 25 クレジット |
| 編集プラン（**チャプター**モード） | 収録の開始した分ごとに、**計画の品質**の料金で課金されます。30 分の収録を**エコノミー**で処理すると 66 クレジットです。 |

- **実行ごとの手数料**は、1 回の実行につき 1 回課金されます。失敗した実行の手数料は返還され、**続行**でまた確保されます。
- **リストは各項目を別々の実行として処理し、** それぞれに手数料がかかります。
- **見積もり**は、編集プランと同じ方法で収録の分数を数えます。長さがわからない収録は、上限の 180 分で見積もられます。編集プランの分数の数え方は、[**編集プラン**](https://nodaro.ai/docs/nodes/video/edit-plan#credits)で説明しています。

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

## トラブルシューティング
| 問題 | 対処 |
| --- | --- |
| 実行が開始前に拒否される | 収録が 3 時間以内で、音声が入っていることを確認してください。 |
| プランがチャプターを見つけられなかった | 別の**指示**か別の収録で、ノードをもう一度実行してください。 |
| 1 つの工程が失敗した | ノードの**続行**を押します。完了した工程は結果を保持し、再び課金されることはありません。 |
| チャプターが 2 つ足りない | ほかのチャプターと同じ秒に始まるチャプターは除かれます。**指示**で、より少なく長いチャプターを頼んでください。 |
| セルフホスティング環境でノードが見つからない | 環境を Nodaro Cloud に接続してください。[Nodaro Cloud への接続](https://nodaro.ai/docs/self-hosting/cloud-connect)を参照してください。 |

## 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` ツールは、同じルートを呼び出します。[単一ノードの実行](https://nodaro.ai/docs/developers/api/nodes)、[SDK での編集](https://nodaro.ai/docs/developers/sdk/editing)、[MCP の分析と EDL のツール](https://nodaro.ai/docs/mcp/tools/analysis-and-edl)を参照してください。

## よくある質問

### チャプターノードは何をしますか？

チャプターノードは、ポッドキャストやインタビューの収録を 1 本受け取り、そのチャプターをタイトルと開始時刻付きで返します。収録を文字起こししてから、チャプターを計画します。レンダリングは行わないため、結果はテキストです。

### 概要欄テキストはどんな形式ですか？

チャプターノードは、チャプターごとに 1 行で、開始時刻とタイトルを書きます。たとえば 0:00 Intro です。最初のチャプターは常に 0:00 から始まります。1 時間以降に始まるチャプターがあると、すべての行が 0:00:00 Intro のように時間付きになります。

### チャプターノードには何クレジットかかりますか？

チャプターノードは、文字起こしとチャプターモードの編集プランという各工程をそれぞれの料金で課金し、さらに 1 回の実行ごとに少額の手数料がかかります。ノードは実行前に、手数料を含む見積もり全体を表示します。

### プランがチャプターを見つけられなかった場合はどうなりますか？

チャプターの実行は「The plan found no chapters in this recording.」（この収録ではチャプターが見つかりませんでした）というメッセージで失敗します。実行ごとの手数料は返還されますが、文字起こしとプランは課金されます。別の指示か別の収録で、ノードをもう一度実行してください。

### 代わりにチャプターモードの編集プランを使うのはどんなときですか？

すでに文字起こしがあるときや、プラン自体のチャプターのオブジェクトが欲しいときは、チャプターモードの編集プランを使います。チャプターノードは、収録から始める 1 ステップ版です。