# クリップパック

> クリップパックノードは、ポッドキャストやインタビューを 1 回で短いクリップのパックに切り分けます。最も良い場面を見つけ、SNS 向けにフレーミングして字幕を付けます。

Source: https://nodaro.ai/ja/docs/nodes/video/clip-pack

**クリップパック**ノードは、ポッドキャストやインタビューの収録を 1 回で短いクリップのパックに切り分けます。最も良い場面を見つけ、それぞれを個別のクリップとして、SNS 向けにフレーミングし、字幕を付けてレンダリングします。[複数のカメラ](#several-cameras)で撮った会話を編集することもできます。

内部では、手作業で接続できるのと同じ工程を実行します。話者ラベルと単語のタイミング付きの[**文字起こし**](https://nodaro.ai/docs/nodes/audio/transcribe)と、**クリップ**モードの[**編集プラン**](https://nodaro.ai/docs/nodes/video/edit-plan)です。そのあとクリップごとに、レンダリング（フレーミングがあれば[**話者ビュー**](https://nodaro.ai/docs/nodes/video/speaker-view)、なければ[**EDL 適用**](https://nodaro.ai/docs/nodes/video/apply-edl)）と、字幕がオンなら[**字幕を追加**](https://nodaro.ai/docs/nodes/video/add-captions)を実行します。各工程はそれぞれ独立したジョブとして実行されるので、長い収録、キャンセル、失敗は、手作業で組んだワークフローと同じように扱われます。

- **場面はプランが選びます。** 編集プランは、**クリップ数**で指定した数まで、それぞれ約**目標の長さ（秒）**の場面を探します。各場面にはタイトルとフックが付きます。見つかる場面は指定より少ないことがあります。パックには見つかったクリップが入り、課金されるのはそのレンダリングだけです。
- **すべてのクリップが試されます。** レンダリングできないクリップは飛ばされ、パックにはほかのクリップが残ります。
- **各クリップは、そのクリップ自体の文字起こしで字幕が付きます。** そのため字幕は、クリップの中の言葉に合います。

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

## 使いどころ
- 1 本のエピソードから、Instagram のリール、TikTok、YouTube ショート向けの縦型の字幕付きクリップを 1 週間分作る。
- 音声だけのポッドキャストから、予告として共有する短い音声の抜粋を作る。
- 場面の候補を出し、確認画面で良いものを残して、それだけをレンダリングする。

工程をより細かく制御したいときは、編集プラン、EDL 適用、話者ビューなどの個別のノードを使います。

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

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

### クリップを決める
探す**クリップ数**と、その**目標の長さ（秒）**を設定します。**フレーミング**は、話者を縦積みにするデフォルトの `9:16` のままにするか、別の形を選びます。

### 実行する
ノードの**実行**をクリックします。ノードには、クリップごとにサムネイルとタイトル付きのチップが 1 つずつ表示されます。チップにカーソルを合わせると、フックが表示されます。

Workflow: クリップパックノードが収録したエピソードの最も良い場面を見つけ、それぞれを字幕付きの縦型クリップとしてレンダリングします。

- 動画アップロード → クリップパック (録音)

テンプレートマーケットプレイスには、すぐに使えるワークフローが 2 つあります。**Clip Pack** は同じチェーンをフレーミングなしで手作業で組んだもので、中身を入れるだけで使えます。**Clip Pack in One Node** はこのノードを使ったもので、**レンダリング前に確認**がオンになっており、話者を縦積みにした `9:16` のフレーミングで約 60 秒のクリップを 8 本作り、カラオケ字幕を付けます。

## 入力
| 入力 | 受け付けるもの | 役割 |
| --- | --- | --- |
| **録音** | 動画またはオーディオ | エピソードの収録で、最長 3 時間です。音声が入っている必要があります。オーディオの収録からは、フレーミングと字幕のない音声クリップが作られます。[複数のカメラ](#several-cameras)では、各カメラの録画です。必須です。 |
| **マスターオーディオ** | オーディオ | [複数のカメラ](#several-cameras)のときの、ミキサーまたはレコーダーのトラックです。パックの音声になります。任意です。 |

3 時間より長い収録や、音声のない収録は、何かが課金される前に拒否されます。

録画が 2 本以上の場合は、**録音**の一覧の順番で最初の録画がカメラ 1 になります。設定パネルには**カメラ**のセクションが表示されます。[複数のカメラ](#several-cameras)を参照してください。

## 出力
| 出力 | 内容 |
| --- | --- |
| **クリップ** | プランが見つけた場面ごとに 1 本のクリップで、プランの順に並び、それぞれが個別の結果です。デフォルトの**個別**接続では、次のノードがクリップごとに 1 回実行されます。オーディオの収録からは音声クリップになります。 |
| **クリップセット（EDL）** | プランのクリップセットです。残したクリップごとに 1 つの編集プランがあり、それぞれにタイトルとフックが付き、確認時の編集が反映されています。 |

字幕を追加できなかったクリップには、ノード上で**字幕なし**と表示されます。

## 設定
| 設定 | 役割 |
| --- | --- |
| **クリップ数** | 1〜50 で、デフォルトは 8 です。探すクリップの数です。プランが見つける数はそれより少ないことがあります。 |
| **目標の長さ（秒）** | 5〜180 で、デフォルトは 60 です。各クリップの目標の長さです。 |
| **フレーミング** | 動画の収録のみです。**なし — 収録時の形のまま**、または形（`16:9`、`9:16`、`1:1`、`4:5`）と、**レイアウト**、**切り替え**、**強調**です。デフォルトは `9:16`、**縦積み**、**パン**、**スケール**です。[フレーミング](#framing)を参照してください。 |
| **フレーミングの方法** | フレーミングを選んだときに表示されます。**自動（顔を追従）**、**均等分割**、**顔を追従**のいずれかです。新しいノードは**自動（顔を追従）**を使います。この設定ができる前に保存されたノードは**均等分割**を使います。[顔の追従](#following-faces)を参照してください。 |
| **字幕** | 動画の収録のみです。デフォルトでオンで、**字幕のスタイル**を選べます。デフォルトのスタイルは**カラオケ（キネティック）**です。 |
| **レンダリング前に確認** | デフォルトでオフです。オンにすると、実行は確認・編集できるクリップの簡易プレビューで止まります。[レンダリング前に確認](#review-before-render)を参照してください。 |
| **編集の品質** | **エコノミー**、**スタンダード**（デフォルト）、**プレミアム**のいずれかです。編集プランの工程のティアで、プランの品質と料金が決まります。 |
| **指示** | プランへの短い指示で、最大 4,000 文字です。例：`the funniest moments`（いちばん面白い場面）。 |
| **スタイルガイド** | プランへの、より長い編集方針で、最大 4,000 文字です。 |

### フレーミング
**フレーミング**を形に設定すると、ノードは各クリップを自動のボックスを使った話者ビューでレンダリングします。どのクリップも、エピソードの話者に対して同じようにボックスが割り当てられます。対象の話者は、文字起こしに名前があり、10 秒以上、またはエピソードの発話時間の 5% 以上話している人です。フレーミングには、1 台のカメラにそうした話者が 2〜6 人映っている必要があります。そうでない場合、クリップではカメラがフルフレームで表示されます。

- **レイアウト**には、選んだ形で話者ビューが描けるレイアウトだけが表示されます。
- **切り替え**は、話者が変わるたびに何が起きるかを決めます。
- **強調**は、話している人を示します。**スケール**、**枠**、**減光**、それらの組み合わせ、またはなしを選べます。

**なし — 収録時の形のまま**を選ぶと、ノードは各クリップを EDL 適用で、収録の形のままレンダリングします。

### 顔の追従
フレーミングを選んだ場合、**フレーミングの方法**で、話者のボックスをどこから取るかを決めます。

- **均等分割**：上記の自動のボックスです。画面上の各話者がフレームを均等に分け合い、どのクリップでも同じボックスになります。
- **顔を追従**：[**話者フレーム**](https://nodaro.ai/docs/nodes/video/speaker-frames)が、パック全体で各顔を 1 回だけ追跡し、すべてのクリップの話者ビューがそれを追従します。プランが切り出したすべてのクリップをまとめた 1 回の実行で、クリップごとには実行しません。話者フレームは、サンプリングした 1,000 フレームのブロックを開始するごとに課金されます。顔と話者の対応付けはまだ行われません。1 人を映すカメラは追従され、複数の話者が同じカメラに映る場合は均等分割でフレーミングされます。
- **自動（顔を追従）**：話者フレームを利用できる間は顔を追従し、そうでなければ均等分割を使います。拒否されることも、追加で課金されることもありません。見積もりや、アプリやテンプレートに表示される料金も、同じルールに従います。

セルフホスティング環境では、話者ビューと同じく、話者フレームには Nodaro Cloud への接続が必要です。話者フレームを利用できない場合、設定パネルにはフレーミングの方法が表示されず、**自動（顔を追従）**は均等分割になります。**顔を追従**に設定したノードには注記が表示され、その実行は、何も課金される前に `403 node_not_available` で拒否されます。

**レンダリング前に確認**がオンの場合、顔は確認の前に、プランが切り出したクリップ上で追跡されます。**最終レンダリング**はその追跡結果を使い、話者フレームを再実行しません。[複数のカメラ](#several-cameras)では、話者フレームは切り替え済みのクリップのすべてのカメラをサンプリングし、マスターオーディオはサンプリングしません。

## 複数のカメラ
各カメラの録画を**録音**に接続します。ミキサーまたはレコーダーのトラックがある場合は、**マスターオーディオ**に接続します。実行は、[**音声同期**](https://nodaro.ai/docs/nodes/audio/audio-sync)で録画を揃え、音声を文字起こしし、[**話者マップ**](https://nodaro.ai/docs/nodes/audio/speaker-map)で各話者がどのカメラに映っているかを判定します。そしてすべての録画にわたってクリップを計画します。そのあとクリップごとに、[**カメラ切り替え**](https://nodaro.ai/docs/nodes/video/camera-switch)が各場面を話している人に合わせ、クリップは録画が 1 本のときと同じようにレンダリングされ、字幕が付けられます。

- **録音。** 1 つの会話の録画を 1〜6 本、順番に接続します：カメラ 1、カメラ 2、というようにです。順番を変えるには、設定パネルの**録音**の一覧でドラッグします。1 本は音声のみでもかまいません。音声のみにできるのは 1 本だけで、マスターオーディオがある場合は音声のみの録画は使えません。
- **マスターオーディオ。** パックの音声で、録画を揃える基準の時間軸です。録画はマスターオーディオを含めて合計 6 本までです。
- **マスターオーディオがない場合。** 引きのカメラ自身の音声、それもなければカメラ 1 の音声が音声になるため、音声がカメラのマイク間で飛ぶことはありません。カメラが 2 台以上の場合は音声用に 1 枠を使うため、カメラは 5 台までです。
- **カメラ 1 台とマスターオーディオ。** カメラはマスターオーディオに揃えられ、その 1 台のカメラでカットされます。カメラの 1 つと同じノードから接続したマスターオーディオは、そのカメラ自身の音声なので、ノードはマスターオーディオがない場合と同じように実行されます。
- **引きのカメラ。** 全員を映すカメラです。専用のカメラがない話者はこのカメラに映り、このカメラが話者のカメラになることはありません。初期値ではなしです。
- **録音はすでに同期済み。** すべての録画がすでに同じ時間軸を共有している場合はオンにします。実行は録画を揃える処理を省くため、音声同期の工程はありません。
- **どのカメラに誰が映っているか。** 初期設定では、話者マップがカメラ自身のマイクから判定します。話者の声を最も大きく拾うカメラが、その人のカメラです。どのカメラもはっきりとリードしていない話者は、はっきりしたカメラがない扱いになり、引きのカメラに、それもなければその人を撮ったいずれかのカメラに映ります。その場合、ノードは結果の下にその旨を表示します。自動の判定を上書きするには、話者にカメラか引きのショットを指定します。話者 1 は最初に聞こえた声、話者 2 はその次の声、という順です。
- **すべてのクリップが試されます。** カメラ切り替えはクリップごとに 1 回実行されます。カメラの切り替えに失敗したクリップは、レンダリングに失敗したクリップと同じく飛ばされ、課金されません。パックはほかのクリップを残します。
- **マルチカメラの工程が失敗した場合。** 音声同期と話者マップは、どのクリップよりも先に実行されます。そのどちらかが失敗すると、クリップは 1 本も作られずに実行は失敗し、実行ごとの手数料は返還されます。**続行**を押すと、失敗した工程とそれ以降の工程が実行されます。
- **レンダリング前に確認。** 複数のカメラでは、確認したパックの**最終レンダリング**は、残した各クリップでカメラ切り替えをもう一度実行してから、そのレンダリングと字幕を実行します。

実行の結果には、誰がどのカメラに割り当てられたかが、録画を揃えた処理と判定のメモとともに示されます。話者マップを利用できない場合、エディターやアプリでの実行は最初の録画だけを読み込み、設定パネルにそのことが表示されます。

次の場合は、何かが課金される前に拒否されます。

- 音声のみの録画が 2 本、または音声のみの録画 1 本とマスターオーディオ。
- 上の上限を超える数の録画。
- 映像のある録画ではない引きのカメラ。
- 有効ではない**カメラ**の設定。
- オーディオとして読み取れないマスターオーディオ。

マスターオーディオのない 1 本の録画の実行では、**カメラ**の設定は無視されます。

## レンダリング前に確認
**レンダリング前に確認**をオンにすると、実行は各クリップのプレビューで止まります。各レンダリングは安いプレビュー料金のプレビューで、非公開の 720p です。字幕はまだ追加されていません。

1. 確認画面を開きます。各クリップがカードとして表示されます。クリップを残すか外すかを選び、フックを編集します。
2. ノードの**最終レンダリング**をクリックします。ノードは、残したクリップだけをフル品質でレンダリングし、それぞれに字幕を 1 回だけ付けます。

- **少なくとも 1 本は残してください。** すべてのクリップを外すと、ノードに「レンダリングするには、少なくとも1つのクリップを残してください。」と表示され、**最終レンダリング**は無効になります。
- **最終レンダリングはプレビューの設定を使います。** フレーミングなどの設定を変えるには、ノードをもう一度実行してください。
- **最終レンダリングはやり直せます。** **最終レンダリング**が完了したあと、確認内容をもう一度編集して**最終レンダリング**をクリックできます。残したクリップのレンダリングと字幕が再実行されて再び課金されますが、手数料はかかりません。同じ編集を 2 回レンダリングすることは拒否され、**最終レンダリング**は一度に 1 つしか実行されません。
- **公開したアプリでは、** ノードはアプリのページにプレビューと**最終レンダリング**ボタンを表示し、このボタンはすべてのクリップをフル品質でレンダリングします。アプリのページには確認画面がないため、クリップは外されません。最終版が作られたあと、同じ実行の**最終レンダリング**をもう一度行うことは拒否されます。[アプリでの最終レンダリング](https://nodaro.ai/docs/concepts/apps#render-final-in-an-app)を参照してください。
- **後続のノードはプレビューで実行されます。** Nodaro Cloud では、ノードはプレビューで止まりますが、後ろに接続したノードはプレビューで実行されて課金されます。**最終レンダリング**のときに、最終版のクリップで再実行されます。
- **確認する人が必要です。** 確認する人がいない実行は、このノードを通過できません。API、SDK、MCP の `run_workflow` ツール、トリガーから開始した実行や、コンポーネント内の実行がこれにあたります。クリップパックノードより前のノードは実行されて課金されます。そのあとノードは `preview_review_required` で失敗し、このノードの分は課金されません。こうした実行では**レンダリング前に確認**をオフにしてください。

MCP の `make_clip_pack` と `continue_use_case` ツールは、それを呼び出す AI アシスタントが確認するので、**レンダリング前に確認**を使えます。

## 実行が失敗した場合
- **レンダリングできなかったクリップ、** または[複数のカメラ](#several-cameras)でカメラの切り替えに失敗したクリップ。実行はレンダリングできたクリップで完了し、手数料はそのまま課金されます。ノードは、「1 本のクリップをレンダリングできませんでした。」のように、レンダリングできなかった本数を示します。失敗したクリップは課金されません。実行は完了しているので、**続行**はありません。足りないクリップを得る方法は 2 つあります。
  - **同じクリップを、手数料なしで。** **クリップセット（EDL）**出力から自分でレンダリングします。EDL 適用ノード（フレーミングした見た目にするなら話者ビューノード）に接続し、接続の選択をそのクリップに設定します。字幕が欲しい場合は字幕を追加ノードを加えます。各工程はそれぞれの料金で課金されます。
  - **新しい実行。** ノードをもう一度実行します。手数料を含むすべての工程が再び課金され、新しいプランは別の場面を選ぶことがあります。
- **字幕を追加できなかったクリップ。** クリップは字幕なしで渡され、**字幕なし**と表示されます。失敗した字幕は課金されません。
- **クリップが 1 本もレンダリングされなかった。** 実行は失敗し、実行ごとの手数料は返還されます。メッセージには本数と理由が書かれます。例：「8 本のクリップはいずれもレンダリングできませんでした：…」。
- **プランがクリップを見つけられなかった。** 実行は「The plan found no clips in this recording.」（この収録ではクリップが見つかりませんでした）で失敗します。何もレンダリングされず、実行ごとの手数料は返還されます。
- **字幕の工程の前に止まった実行。** 実行は失敗し、実行ごとの手数料は返還されます。**続行**を押すと、レンダリング済みのクリップを再レンダリングせずに字幕を付けます。
- **そのほかの失敗した実行。** 完了した工程は完了したままです。文字起こし、プラン、レンダリング済みのクリップなどの結果は保持され、再び課金されることはありません。ノードの**続行**を押すと、失敗した工程とそのあとの工程だけが再実行されます。

## リストの項目ごとには実行できない
クリップパックノードは 1 つの会話の収録を受け取り、その結果はすでにリスト（クリップごとに 1 つ）です。リストから入力されるクリップパックノードは、どの実行も始まる前に、課金なしで拒否されます。メッセージは「Clip Pack takes the recordings of one conversation. Use a separate workflow run for each episode.」（クリップパックは 1 つの会話の収録を受け取ります。エピソードごとに別々のワークフロー実行を使ってください）です。

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

| 工程 | 料金 |
| --- | --- |
| 文字起こし（ElevenLabs STT） | 1 回の実行につき 25 クレジット |
| 編集プラン（**クリップ**モード） | 固定分と、収録の開始した分ごとの料金で、どちらも**編集の品質**で決まります。90 分の収録を**プレミアム**で処理すると 836 クレジットです。 |
| 話者ビュー（クリップごと、フレーミングあり） | クリップの 1 分ごとに課金されます。画面上の話者が 2 人以下でズームがないクリップ（デフォルトの 2 人の縦積みのフレーミングなど）は、1 分あたり 11 クレジットです。それ以外のクリップは 1 分あたり 14 クレジットです。プレビューは 1 分あたり 3 または 4 クレジットです。[**話者ビュー**](https://nodaro.ai/docs/nodes/video/speaker-view#credits)を参照してください。 |
| EDL 適用（クリップごと、フレーミングなし、またはオーディオ） | クリップの 1 分あたり 11 クレジットです。プレビューは 1 分あたり 2 クレジットです。 |
| 字幕を追加（クリップごと、オンの場合） | **カラオケ（キネティック）**では 55 クレジットです。ほかのスタイルは、字幕のスタイルに応じて 33〜55 クレジットです。 |
| 話者フレーム（フレーミングが顔を追従する場合） | パック全体で 1 回だけ、サンプリングした 1,000 フレームのブロックを開始するごとに課金され、実行の合計を 1 回だけ切り上げます。見積もりでは、エピソードの長さに両端 2 秒ずつを加えた長さを、1 秒あたり 2 フレームで数えます。実行では、クリップ自体のフレームに対して課金されます。[**話者フレーム**](https://nodaro.ai/docs/nodes/video/speaker-frames#credits)を参照してください。 |
| [複数のカメラ](#several-cameras) | 音声と各カメラに対する[**音声同期**](https://nodaro.ai/docs/nodes/audio/audio-sync)で、揃える録画の数によって料金が決まります。録画がすでに同期済みの場合、音声同期はありません。[**話者マップ**](https://nodaro.ai/docs/nodes/audio/speaker-map)はパック全体で 1 回、実行ごとの一律の料金です。カメラが 2 台以上の場合は、クリップごとに 1 回の[**カメラ切り替え**](https://nodaro.ai/docs/nodes/video/camera-switch)も加わり、実行ごとの一律の料金です。編集プランは音声の長さで料金が決まります。 |

- **実行ごとの手数料**は、1 回の実行につき 1 回課金されます。確認後の**最終レンダリング**では、手数料は再び課金されません。失敗した実行の手数料は返還され、**続行**でまた確保されます。一部のクリップだけが残った実行にも、手数料が課金されます。
- **課金は各クリップ自体の長さに対して行われ、** 見積もりに対してではありません。各クリップのレンダリングは、そのクリップの分数（クリップごとに切り上げ）とそのクリップの料金で課金されます。レンダリングされなかったクリップはレンダリングの分が、字幕のないクリップは字幕の分が課金されません。

### 実行前の見積もり
見積もりは、各クリップを**目標の長さ（秒）**の 2 倍で計算するため、高めに出ます。デフォルトの 60 秒では、各クリップのレンダリングは 2 分で見積もられます。フレーミングがある場合、話者ビューは、プレビューと**最終レンダリング**も含めて高いほうの料金で見積もられます。例外は、ズームの切り替えがない**シングル**レイアウトで、低いほうの料金で見積もられます。プランが見つける数はそれより少ないことがありますが、見積もりは指定したクリップ数で数えます。プレビューのあとの**最終レンダリング**は、残したクリップを、それぞれの長さで見積もります。長さがわからない収録は、編集プランの上限の 180 分で見積もられます。編集プランの分数の数え方は、[**編集プラン**](https://nodaro.ai/docs/nodes/video/edit-plan#credits)で説明しています。

### クリップパックの後のノード
**クリップ**出力に**個別**接続でつないだノードは、クリップごとに 1 回実行され、クリップごとに課金されます。たとえば、8 本のパックの後ろにある[**SNS フォーマット**](https://nodaro.ai/docs/nodes/video/social-media-format)ノードは、8 回課金されます。見積もりは指定したクリップ数で数え、実行では渡されたクリップに対して課金されます。

## ヒント
- **場面を指定する。** **指示**を使います。例：`the funniest moments`（いちばん面白い場面）、`only the part about pricing`（料金の話の部分だけ）。
- **弱いクリップを先に外す。** **レンダリング前に確認**をオンにすると、フル品質でレンダリングする前に、弱いクリップを外してフックを磨けます。
- **各クリップを 1 回ずつ投稿する。** **クリップ**を**個別**接続で投稿用のノードに接続します。

## トラブルシューティング
| 問題 | 対処 |
| --- | --- |
| 実行が開始前に拒否される | 収録が 3 時間以内で、音声が入っていることを確認してください。複数のカメラでは、録画の数と**カメラ**の設定を確認してください。[複数のカメラ](#several-cameras)を参照してください。 |
| 最初の録画だけが使われた | 話者マップを利用できないため、ノードは最初の録画だけを読み込みます。設定パネルにそのことが表示されます。 |
| リストがノードの実行を拒否する | クリップパックノードは 1 つの会話を受け取ります。エピソードごとに別々のワークフロー実行を使ってください。 |
| **最終レンダリング**が無効になっている | 確認画面ですべてのクリップが外されています。少なくとも 1 本は残してください。 |
| クリップに**字幕なし**と表示される | そのクリップには字幕を追加できませんでした。そのクリップに字幕を追加ノードを実行してください。 |
| クリップでカメラがフルフレームで表示される | フレーミングには、十分に長く話す話者が 1 台のカメラに 2〜6 人映っている必要があります。 |
| ノードが `preview_review_required` で失敗する | 実行にプレビューを確認する人がいませんでした。API、SDK、トリガー、コンポーネントからの実行では、**レンダリング前に確認**をオフにしてください。 |
| セルフホスティング環境でノードが見つからない | 環境を Nodaro Cloud に接続してください。[Nodaro Cloud への接続](https://nodaro.ai/docs/self-hosting/cloud-connect)を参照してください。 |

## API から
`POST /v1/clip-pack` は実行を開始し、`jobId` と `executionId` を付けて `202` を返します。本文には `mediaUrls`（収録の URL 1 つ、または 1 つの会話の録画を順番に最大 6 つ）を指定し、任意で `masterAudioUrl`、`cameras`、`count`、`targetDurationSec`、`framing`、`framingSource`、`captions`、`captionStyle`、`reviewBeforeRender`、`planTier`、`instructions`、`styleGuide` を指定します。ジョブは `GET /v1/jobs/:id/status` でポーリングします。

- `framing` は `{ aspect, layout, switchType, emphasisStyle }` です。省略するとデフォルト（`9:16`、縦積み、パン、スケール）になります。`layout` のないフレーミングは縦積みになり、その形で描けるレイアウト（`16:9` では横並び）に置き換えられます。`null` は収録の形でレンダリングします。ノードが描けない `emphasisStyle` には `400 validation_error` が返ります。
- `framingSource` は `"auto"`、`"static"`、`"tracking"` のいずれかです。省略すると `"static"`（均等分割）になります。話者フレームを利用できない場合、`"tracking"` は `403 node_not_available` で拒否されます。
- `cameras` は `{ wide?, synced?, speakerCameras? }` です。`wide` は引きのカメラの録画番号、または `null` です。`synced: true` は録画を揃える処理を省きます。`speakerCameras` は話者番号を録画番号に対応付け、`0` は引きのショットです。[複数のカメラ](#several-cameras)を参照してください。
- 複数の録画や `masterAudioUrl` には話者マップが必要です。話者マップを利用できない場合、これらは何かが課金される前に `403 node_not_available` で拒否されます。
- ジョブの `output_data` には、クリップ（`clips`、プランの順の `{ url, title, hook, clipKey, thumbnailUrl, captionsFailed }` のリスト）と、その最初のものが `videoUrl`（音声クリップでは `audioUrl`）として入ります。`failedClips` はレンダリングできなかったクリップ（カメラの切り替えに失敗したクリップを含む）の数、`failedCaptions` は字幕のないクリップの数で、どちらもある場合のみ入ります。クリップセット（`json`）、文字起こし（`transcript`）、`quality`（プレビューでは `proxy`、それ以外は `final`）も入ります。複数の録画またはマスターオーディオでの実行では `cameras` が加わり、各話者、その話者に割り当てられたカメラの録画番号（引きのショットは `null`）、録画を揃えた処理と判定のメモが入ります。失敗した実行は完了した部分を保持し、失敗した工程を `failedStep` で示します。
- `Idempotency-Key` ヘッダーを付けると、同じリクエストを再試行したときに同じ `jobId` と `"deduped": true` が返り、何も開始されません。
- `POST /v1/clip-pack/estimate` は同じ本文を受け取り、何も開始せずに `{ data: { totalCredits, stepsCredits, feeCredits, durationSec } }` を返します。
- `POST /v1/clip-pack/continue` に `{ jobId, mode }` を渡すと、実行を続行します。`"mode": "from-failed"` は、失敗した実行で完了しなかった部分を実行します。`"mode": "render-final"` は、確認用の実行で残したクリップをレンダリングし、任意で、クリップを残すか外すかとフックの編集を含む `editedEdl` を受け取ります。すべてのクリップを外した確認内容には `409 use_case_nothing_kept` が返ります。プレビューではなかった実行の最終レンダリングには `render_final_not_preview` が、すでにレンダリングされた編集の最終レンダリングには `render_final_already_rendered` が返ります。

SDK（`client.edit.clipPack`、`client.edit.estimateClipPack`、`client.edit.continueUseCase`）、CLI（`nodaro edit clip-pack`、見積もりには `--estimate`、および `nodaro edit continue-use-case`）、MCP の `make_clip_pack`、`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 本受け取り、短いクリップのパックを返します。収録を文字起こしし、最も良い場面を見つけ、各場面を個別のクリップとしてレンダリングして字幕を付けます。デフォルトでは、各クリップは縦型の 9:16 の動画です。

### クリップパックは何本のクリップを作りますか？

クリップパックノードは、クリップ数で指定した本数（1〜50、デフォルトは 8）まで探します。プランが見つける場面はそれより少ないことがあります。パックには見つかったクリップが入り、課金されるのはそのレンダリングだけです。

### 最終レンダリングの前に、残すクリップを選べますか？

はい。クリップパックノードでレンダリング前に確認をオンにします。実行は簡易プレビューで止まり、確認画面では各クリップがカードとして表示され、残すか外すかを選べます。そのあと最終レンダリングで、残したクリップだけがフル品質でレンダリングされます。

### クリップパックには何クレジットかかりますか？

クリップパックノードは、文字起こし、編集プラン、クリップごとのレンダリングと字幕という各工程をそれぞれの料金で課金し、さらに 1 回の実行ごとに少額の手数料がかかります。ノードは実行前に見積もり全体を表示し、その見積もりは高めに出ます。

### クリップパックは音声だけのポッドキャストにも使えますか？

はい。クリップパックノードは、オーディオの収録から音声クリップを作ります。フレーミングと字幕は付きません。

### クリップパックで、複数のカメラで撮ったポッドキャストを編集できますか？

できます。1 つの会話の録画を最大 6 本まで録音に接続し、ミキサーのトラックがあればマスターオーディオに接続します。クリップパックノードは録画を揃え、各話者がどのカメラに映っているかを判定して、すべてのクリップの各場面を話している人に合わせます。

### 1 本のクリップがレンダリングに失敗した場合はどうなりますか？

クリップパックの実行はそのクリップを飛ばし、ほかのクリップを残して完了します。ノードはレンダリングできなかったクリップの本数を示し、失敗したクリップは課金されません。