# UGC クリップ

> UGC 動画のクリップをテイクごとにレンダリングし、2 つのフレームで確認します。確認に通らなければもう一度レンダリングし、気に入らないクリップだけを再レンダリングできます。

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

**UGC クリップ**ノードは、UGC 動画のクリップを 1 本レンダリングします。クリエイターがそのクリップの行を話す映像です。[**UGC クリップ一覧**](https://nodaro.ai/docs/nodes/video/ugc-clips)が作ったクリップごとに 1 回実行されます。クリップに音声がある場合は、先にボイスが作られます。ボイスがクリップより長いと、クリップはそれに合わせて長くなります。

- Found in: Video › UGC Video
- API type: `ugc-clip`

各レンダリングは確認されます。2 つのフレームをクリエイターの画像と並べて読み取り、よくないテイクを見つけます。確認に通らなければ、クリップをもう一度レンダリングして、再び確認します。新しいテイクが確認に通れば、そちらが保持されます。通らなければ最初のテイクが保持され、[**UGC カード**](https://nodaro.ai/docs/nodes/video/ugc-cards)のメモに、確認で見つかった内容が書かれます。確認そのものを実行できなかった場合、テイクは確認なしで保持され、メモにそのことが書かれます。

ヘブライ語の動画では、各レンダリングが、クリップの録音した音声とも照合されます。音のないレンダリングはこの確認に通らず、もう一度レンダリングされます。どのレンダリングにも音がない場合、クリップは「クリップ N に音声がないため、動画を仕上げられません。「UGC クリップ」ノードからそのクリップを再レンダリングしてください。」というメッセージで止まります。

ノードには、レンダリングしたクリップと、それらに付いた警告の数が表示されます。

UGC クリップは Nodaro Cloud でのみ動作します。それ以外の環境では、すべての UGC ノードが、何も確保される前に「UGC 動画は Nodaro Cloud の機能のため、このインスタンスでは提供されていません。」というメッセージで失敗します。

## 使いどころ
- UGC クリップ一覧のクリップがあり、それをレンダリングしたい。
- ほかのクリップをレンダリングし直さずに、1 本のクリップだけ新しいテイクを作りたい。

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**動画 › UGC 動画 › UGC クリップ**を選びます。

### クリップを接続する
UGC クリップ一覧の**クリップ**出力を**クリップ**に接続します。UGC クリップがクリップごとに 1 回実行されるように、その接続は**個別**モードのままにします。

### クリップをつなぐ
**動画**出力を [**UGC 仕上げ**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)に接続し、その接続を**一括**モードにします。UGC 仕上げを[**動画を結合**](https://nodaro.ai/docs/nodes/video/combine-videos)に接続し、こちらも**一括**モードにします。**動画**は UGC カードの**クリップのメモ**入力にも接続します。

### 実行して確認する
ワークフローを実行します。各クリップを見ます。気に入らないクリップがあれば**再レンダリング**を押し、もう一度実行します。

Workflow: UGC クリップが各クリップをレンダリングします。UGC 仕上げがそれらを順番どおりに渡し、動画を結合が一括の接続でそれらをつなぎ、UGC カードがカードと字幕のタイミングを決め、動画オーバーレイと字幕を追加がそれらを描きます。

- UGC クリップ一覧 → UGC クリップ (個別)
- UGC クリップ → UGC 仕上げ (一括)
- UGC 仕上げ → 動画を結合 (一括)
- UGC クリップ → UGC カード (クリップのメモ)
- 動画を結合 → UGC カード (動画)
- UGC カード → 動画オーバーレイ (レイヤープラン)
- 動画オーバーレイ → 字幕を追加 (動画)

## 入力
| 入力 | 必須 | 接続するもの |
| --- | --- | --- |
| **クリップ** | はい | UGC クリップ一覧の**クリップ**出力からの 1 本のクリップ。接続しないと、ノードは「「UGC クリップ一覧」の「クリップ」出力を接続してください。」というメッセージで失敗します。 |

## 出力
| 出力 | 内容 |
| --- | --- |
| **動画** | 完成したクリップ。任意の動画入力に渡せる、通常の動画です。 |

UGC クリップからの接続は、デフォルトで**選択中**モードで、クリップを 1 本だけ渡します。[**UGC 仕上げ**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)への接続、または動画を結合への直接の接続は**一括**モードにしてください。すべてのクリップが順番どおりに渡されます。ヘブライ語の動画では、つなぐ前に UGC 仕上げが必要です。英語の動画では、UGC 仕上げはクリップをそのまま渡し、料金はかかりません。クリップが 1 本の動画は、そのまま動画を結合を通過し、料金はかかりません。[接続モード](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes)を参照してください。

同じ出力は UGC カードの**クリップのメモ**入力にも渡され、UGC カードは各クリップの警告と実際の長さを読み取ります。

## 設定
UGC クリップ自体には設定がありません。設定パネルには、前回の実行のクリップが、それぞれの長さ、警告、**再レンダリング**ボタンとともに一覧表示されます。

### クリップを再レンダリングする
クリップの**再レンダリング**を押します。クリップに「次回の実行で再レンダリング」と表示されます。UGC クリップかワークフローの次の実行では、そのクリップがもう一度レンダリングされ、ほかのクリップはすべて料金なしで再利用されます。

エディターでは、内容が変わっていないクリップはレンダリングし直されません。次の実行では、すでに作ったテイクが料金なしで返されます。クリップがもう一度レンダリングされるのは、その行、クリエイター、ボイスが変わったときです。新しいスクリプトや新しいクリエイターでは、すべてのクリップがもう一度レンダリングされます。公開したアプリの実行では、その動画のすべてのクリップがレンダリングされます。

### すべてか、なしか
いずれかのクリップが失敗すると、UGC クリップ全体が失敗します。そのため、後ろの**一括**接続が一部だけのリストを受け取ることはなく、クリップが欠けたまま結合した動画が作られることもありません。完了したクリップは保持されて請求されます。エディターでの次の実行では、それらを料金なしで再利用し、失敗したものだけをレンダリングします。

## クレジット
クリップの料金は次のとおりです。

- クリップの長さに対する動画モデルの料金
- クリップに音声がある場合は、ボイス
- レンダリングごとに 1 回のフレーム読み取り

クリップのレンダリング中、ノードは見込み額の約 2 倍を確保し、使わなかった分を戻します。

- **再レンダリング**には、動画の料金とフレーム読み取りが再びかかります。ボイスは 1 回だけ作られます。
- **失敗したクリップ**は請求されません。
- **クリップの料金が確保した額を超えることはありません。** ボイスによってクリップが長くなった場合、長くなったクリップは、同じ確保額の中で新しい長さの料金になります。再レンダリングは、残りの額で 1 回分をまかなえる場合にだけ行われます。まかなえなかった場合は、メモにそのことが書かれます。
- **前回の実行から返されたクリップ**には料金がかかりません。

### アプリやテンプレートの表示価格では
アプリやテンプレートの表示価格では、UGC 動画を、実行する人が実行するとおりに計算します。公開されるものでは保持がオフなので、価格には常にスクリプトとクリエイター 1 人が含まれ、スクリプトの長さの設定で計算されます。「動画を結合」「動画のトリミング」「動画をループ」「動画の効果音」など、入力の長さで料金が決まるステップを、UGC クリップの出力の後ろに置くことができます。そのようなステップは、動画自体の結合を除き、UGC クリップを、どの動画モデルでも作れる最長の長さのクリップ 1 本として計算します。

## エディターでの料金
UGC ノードを含む実行の前に、エディターはその実行の UGC 部分の料金を、サーバー自体の金額で算出します。この金額は、すべてのクリエイター候補を含め、その実行で実行されるノードだけを対象にします。表示される料金は、その実行にかかる見込みの額です。

次に、クリップのレンダリング中に実行が確保する額、つまりクリップの料金の約 2 倍と、残高を照らし合わせます。使わなかった分は、クリップが終わると戻ります。ヘブライ語の動画では、録音した音声によってクリップの数が決まります。そのため、このチェックでは、長さに通常必要なクリップではなく、その動画の受け入れられるどの録音からも切り出せる最大数のクリップ分を確保します。録音は、目標の長さの最大 1.2 倍までで、21 秒を超えることはありません。残高がそれに満たないと、何かが始まる前に実行が拒否され、クレジット購入のダイアログが開きます。

この確認は、実行を始めるすべての方法に適用されます。**実行**、**ここから実行**、**ここまで実行**、**選択したノードを実行**、ノード自身の実行ボタン、**最終レンダリング**、**プレビューを更新**です。UGC 部分のない実行は、通常どおりに確認されます。

- サーバーの金額が届くまで、実行ボタンにはエディター自体の見積もりが表示されます。
- 金額を確認できない場合、実行は始まる前に、理由を示して確認を求めます。そのとき、**最終レンダリング**と**プレビューを更新**は、料金に「（概算）」と表示します。
- 保持したクリエイターやスクリプトには料金がかかりません。保持したスクリプトは、そのスクリプト自体の長さとスクリーンショットカードで計算されます。
- 変わっていないクリップは料金なしで再利用されるため、実行の料金が表示より少なくなる場合があります。

公開したアプリの実行も、始まる前に同じように確認されます。その UGC 動画がレンダリング中に確保しうる額と照らし合わせます。

## ヒント
- **つなぐ前に各クリップを見る。** 気に入らないクリップの**再レンダリング**を押してから、もう一度実行します。そのクリップだけがレンダリングされます。
- **UGC カードのメモを読む。** 「クリップ 2 は行をそのとおりに話していない可能性があります」のようなメモが、再レンダリングすべきクリップを示します。
- **長い実行のあとはエディターを開き直す。** エディターを閉じている間に実行が終わった場合、エディターを開き直すと、その実行の結果が UGC ノードと、動画自体の結合、オーバーレイ、字幕に表示されます。新しい実行が優先されます。UGC クリップとその 3 つのノードは、新しい動画を先頭に表示し、古いものをその下に残します。
- **公開してもテイクは含まれません。** **この実行結果を含める**を付けて公開したテンプレートでは、各クリップの現在のテイクが例として表示されます。

## トラブルシューティング
| メッセージまたは問題 | 原因と対処 |
| --- | --- |
| 「「UGC クリップ一覧」の「クリップ」出力を接続してください。」 | **クリップ**に何も接続されていません。UGC クリップ一覧の**クリップ**出力を接続してください。 |
| 動画を結合が 1 本のクリップしか受け取らない。 | UGC クリップからの接続が**選択中**モードです。**一括**モードにしてください。 |
| 実行が始まる前に拒否され、クレジット購入のダイアログが開く。 | 残高が、クリップのレンダリング中に実行が確保する額（クリップの料金の約 2 倍）に満たないためです。クレジットを追加するか、短い動画にしてください。 |
| 「クリップ N に音声がないため、動画を仕上げられません。「UGC クリップ」ノードからそのクリップを再レンダリングしてください。」 | ヘブライ語の動画で、そのクリップのどのレンダリングにも音がありませんでした。そのクリップの**再レンダリング**を押して、もう一度実行してください。 |
| クリップの見た目がおかしい。 | そのクリップの**再レンダリング**を押して、もう一度実行してください。 |
| UGC クリップは失敗したが、一部のクリップは完了した。 | 1 本のクリップが失敗したため、ノード全体が失敗しました。もう一度実行してください。エディターでは、完了したクリップが料金なしで再利用されます。 |

## API から
UGC クリップは、実行時に `POST /v1/ugc/clip` を呼び出し、このルートはジョブ ID を返します。UGC のルートのリクエストとレスポンスの形はノードのためのもので、バージョンによって変わる場合があります。コードから UGC 動画を作るには、UGC ノードを含むワークフローか公開したアプリを実行してください。[ワークフロー](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values)を参照してください。

公開したアプリによる UGC 動画の実行は、始まる前に確認されます。クリップのレンダリング中に動画が確保しうる額を支払う人がまかなえない場合、何かが実行または請求される前に、実行は `402 insufficient_credits` で拒否されます。メッセージは「この動画は、レンダリング中に最大で約 … クレジットを確保する場合があります。残高は … です。」です。[ミニアプリ](https://nodaro.ai/docs/concepts/apps#embed-a-miniapp-or-run-it-from-code)と[クレジット](https://nodaro.ai/docs/developers/api/credits)を参照してください。

## よくある質問

### UGC クリップノードは何をしますか？

UGC クリップは、UGC 動画のクリップを 1 本レンダリングします。クリエイターがそのクリップの行を話す映像です。UGC クリップ一覧が作ったクリップごとに 1 回実行され、各レンダリングの 2 つのフレームを確認します。

### クリップを 1 本の動画につなぐにはどうすればよいですか？

UGC クリップの「動画」出力からの接続を「一括」モードにして、「動画を結合」に接続します。動画を結合が、クリップを順につなぎます。

### 1 本のクリップだけを再レンダリングできますか？

はい。設定パネルで、気に入らないクリップの「再レンダリング」を押してから、もう一度実行します。そのクリップだけがレンダリングされ、ほかのクリップは料金なしで再利用されます。

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

クリップの料金は、クリップの長さに対する動画モデルの料金に、ボイスと、レンダリングごとに 1 回のフレーム読み取りを加えたものです。エディターは、実行の前にその実行の料金を表示します。

### UGC の実行で、料金より多くのクレジットが確保されるのはなぜですか？

クリップのレンダリング中、実行はクリップの見込みの料金の約 2 倍を確保します。使わなかった分は、レンダリングが終わると戻ります。

### 1 本のクリップが失敗するとどうなりますか？

UGC クリップ全体が失敗するため、クリップが欠けたまま結合した動画が作られることはありません。完了したクリップは保持されて請求され、エディターでの次の実行では料金なしで再利用されます。