# UGC クリップ一覧

> UGC 動画のスクリプトをテイクごとのクリップに分け、クリエイターのボイスを選び、クリップとその後のステップの料金をレンダリング前に確認します。

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

**UGC クリップ一覧**ノードは、UGC 動画のスクリプトをテイクごとのクリップに分けます。[**UGC スクリプト**](https://nodaro.ai/docs/nodes/video/ugc-script)のスクリプトと [**UGC クリエイター**](https://nodaro.ai/docs/nodes/video/ugc-creator)のクリエイターを受け取り、スクリプトをもう一度確認します。各クリップは [**UGC クリップ**](https://nodaro.ai/docs/nodes/video/ugc-clip)に渡され、そこでレンダリングされます。

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

動画のクリップの数は、動画の長さと行によって決まります。ノードには、クリップとそれぞれの長さが表示されます。このノードだけを実行すると、クリップとその後のステップにかかる料金も表示されます。

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

## 使いどころ
- UGC スクリプトのスクリプトと UGC クリエイターのクリエイターがあり、動画をレンダリングしたい。
- クリップをレンダリングする前に、その料金を確認したい。
- クリエイターが話すボイスを選びたい。

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

### スクリプトとクリエイターを接続する
UGC スクリプトの**スクリプト**出力を**スクリプト**に接続します。UGC クリエイターの**クリエイター**出力を**クリエイター**に接続します。

### 出力を接続する
**クリップ**を UGC クリップの**クリップ**入力に接続します。**スクリプト（長さ調整済み）**と**文字起こし**を、[**UGC カード**](https://nodaro.ai/docs/nodes/video/ugc-cards)の同じ名前の入力に接続します。**スクリプト（長さ調整済み）**は、[**UGC 仕上げ**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)の**スクリプト**入力にも接続します。

### 実行する
ノード自身の実行ボタンを押すと、クリップとその料金が表示されます。ワークフロー全体を実行すると、そのままクリップのレンダリングに進みます。

Workflow: UGC クリップ一覧がスクリプトをクリップに分けます。UGC クリップはクリップごとに 1 回実行され、UGC カードはクリップの区切りが記されたスクリプトを受け取ります。

- UGC スクリプト → UGC クリップ一覧 (スクリプト)
- UGC クリエイター → UGC クリップ一覧 (クリエイター)
- UGC クリップ一覧 → UGC クリップ (クリップ)
- UGC クリップ一覧 → UGC カード (スクリプト（長さ調整済み）)

## 入力
| 入力 | 必須 | 接続するもの |
| --- | --- | --- |
| **スクリプト** | はい | UGC スクリプトの**スクリプト**出力。接続しないと、ノードは「「UGC スクリプト」の「スクリプト」出力を接続してください。」というメッセージで失敗します。 |
| **クリエイター** | はい | UGC クリエイターの**クリエイター**出力。UGC クリエイターにクリエイターがいない間は、ノードは「「UGC クリエイター」にはまだクリエイターがいません。実行するか、候補から 1 つを選んでください。」というメッセージで失敗します。これは、UGC クリエイターをまだ実行していないときや、候補があなたの選択を待っているときに起こります。 |

## 出力
| 出力 | 内容 |
| --- | --- |
| **クリップ** | テイクごとのクリップ。**クリップ**からの接続はデフォルトで**個別**モードなので、UGC クリップはクリップごとに 1 回実行されます。クリップが 1 本の動画では、UGC クリップにその 1 本が渡されます。 |
| **スクリプト（長さ調整済み）** | クリップの区切りが記されたスクリプトを表す JSON。UGC カードと [**UGC 仕上げ**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)の**スクリプト**入力に渡します。値は 1 つです。 |
| **文字起こし** | プレーンテキスト。クリップで話されるすべての言葉を順に並べたもので、UGC カードの**文字起こし**入力に渡します。値は 1 つです。 |

項目ごとに分かれて渡されるのは**クリップ**だけです。ほかの 2 つの出力は、接続のモードにかかわらず、値を 1 つ渡します。[接続モード](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes)を参照してください。

## 設定
| 設定 | 内容 |
| --- | --- |
| **ボイス** | クリエイターが話すボイス。**デフォルトのボイス**では、クリエイターに合ったボイスが選ばれます。ボイスブラウザーから好きなボイスを選ぶこともできます。 |

### スクリプトの再確認
UGC クリップ一覧は、スクリプトが動画のルールに沿っているか、もう一度確認します。スクリプトがルールに反するのは、UGC スクリプトで行を編集したときだけです。そのようなスクリプトは、クリップの料金がかかる前に、「スクリプトに修正が必要です：」に続けて各問題とその対処を示すメッセージで、UGC クリップ一覧を失敗させます。

### ヘブライ語のスクリプト
ヘブライ語のスクリプトは、まず選んだボイスで 1 つの音声として録音されます。その単語のタイミングが取られ、音声は間の位置で分けられます。そのあと UGC クリップ一覧は、分けた部分ごとに 1 本のクリップを渡します。各クリップは最長 7 秒です。この 3 つのステップには、それぞれの料金がかかります。

録音は動画の長さの最大 1.2 倍までで、21 秒を超えることはありません。それより長い録音では、実行が分割の段階で「SPEECH_TOO_LONG … Shorten the script.」（…スクリプトを短くしてください）で止まります。分割の料金は返還されます。音声と単語のタイミングの料金は請求されたままです。[**UGC スクリプト**](https://nodaro.ai/docs/nodes/video/ugc-script)は、動画の長さに対して長すぎるヘブライ語のスクリプトを、1 秒あたり 2.5 語で数えてあらかじめ書き直します。15 秒の動画では 45 語、最大でも 52 語です。

ヘブライ語のボイスは、Maya と Shira（女性）、Itai と Omer（男性）です。

ヘブライ語の動画のクリップをレンダリングする前に、UGC クリップ一覧は、分割で渡されたクリップの料金を、その後のステップとあわせて算出します。各クリップは、レンダリング中に確保する額で計算されます。UGC クリップ一覧は、その料金を、実行の開始前に残高と照らし合わせた額、つまりその動画の受け入れられるどの録音からも切り出せる最大数のクリップ分と比べます。クリップの確保額がそれを上回る場合、どのクリップもレンダリングされる前に、実行はここで止まります。音声、単語のタイミング、分割の料金は請求されたままです。ノードは「この録音のクリップは、この実行で確認した金額を超えるため、どのクリップもレンダリングしませんでした。「UGC クリップ一覧」をもう一度実行して、音声を録音し直してください。」というメッセージで失敗します。このチェック自体は無料です。

ヘブライ語の動画では、UGC クリップの後に [**UGC 仕上げ**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)を置き、UGC クリップ一覧の**スクリプト（長さ調整済み）**出力をそこに接続する必要があります。接続しないと、UGC クリップ一覧は何も使う前に「「UGC クリップ」の後に「UGC 仕上げ」ノードを追加し、「UGC クリップ一覧」の「スクリプト（長さ調整済み）」出力を接続してください。」というメッセージで失敗します。

### クリップの料金
UGC クリップ一覧をノード自身の実行ボタンで実行すると、ノードにクリップの料金が表示されます。

- **クリップの行：** クリップごとに 1 行で、その長さが表示されます。
- **ステップの行：** クリップの後の各ステップごとに 1 行です。ステップは、ヘブライ語の動画でのクリップの仕上げ、クリップが複数ある場合のクリップの結合、単語のタイミング、話し声の確認、スクリーンショットカードがある場合はそのカード、そして字幕です。
- **見込み：** 動画にかかる見込みの料金です。
- **クリップのレンダリング中に保留：** クリップのレンダリング中に実行が保留する額で、クリップの料金の約 2 倍です。

このように UGC ノードを 1 つずつ実行すると、クリップをレンダリングする前に金額を確認できます。ワークフロー全体を実行すると、そのままクリップに進むため、UGC クリップ一覧には金額が表示されません。その場合の料金は、実行の前に表示されます。[エディターでの料金](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor)を参照してください。

## クレジット
UGC クリップ一覧は無料です。表示される金額は、UGC クリップとその後のステップにかかる料金です。[UGC クリップのクレジット](https://nodaro.ai/docs/nodes/video/ugc-clip#credits)を参照してください。

## ヒント
- **先に料金を確認する。** UGC スクリプト、UGC クリエイター、UGC クリップ一覧を、それぞれ自身の実行ボタンで 1 つずつ実行すると、クリップをレンダリングする前に料金を確認できます。
- **レンダリングの前にクリップの長さを確認する。** 動画が長いほど、クリップは多くなります。
- **接続のモードはデフォルトのままにする。** **クリップ**が**個別**モードなので、UGC クリップはクリップごとに 1 回実行されます。

## トラブルシューティング
| メッセージまたは問題 | 原因と対処 |
| --- | --- |
| 「「UGC スクリプト」の「スクリプト」出力を接続してください。」 | **スクリプト**に何も接続されていません。UGC スクリプトの**スクリプト**出力を接続してください。 |
| 「「UGC クリエイター」にはまだクリエイターがいません。実行するか、候補から 1 つを選んでください。」 | UGC クリエイターを実行するか、その候補のいずれかで**これを使う**を押してください。 |
| 「スクリプトに修正が必要です：」 | 編集した行が動画のルールに反しています。メッセージが示す各問題を UGC スクリプトで直すか、UGC スクリプトをもう一度実行してください。 |
| 「「UGC クリップ」の後に「UGC 仕上げ」ノードを追加し、「UGC クリップ一覧」の「スクリプト（長さ調整済み）」出力を接続してください。」 | スクリプトがヘブライ語で、**スクリプト（長さ調整済み）**出力を受け取る UGC 仕上げがありません。UGC クリップの後に [**UGC 仕上げ**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)を追加して接続してください。何も使われていません。 |
| 「SPEECH_TOO_LONG … Shorten the script.」（…スクリプトを短くしてください） | ヘブライ語の録音が、動画の長さの 1.2 倍より長いか、21 秒より長くなっています。UGC スクリプトでスクリプトを短くするか、UGC スクリプトをもう一度実行してください。分割の料金は返還されます。 |
| 「この録音のクリップは、この実行で確認した金額を超えるため、どのクリップもレンダリングしませんでした。「UGC クリップ一覧」をもう一度実行して、音声を録音し直してください。」 | ヘブライ語の録音が、実行で確認した額より多くを確保するクリップに分けられました。UGC クリップ一覧をもう一度実行して、音声を録音し直してください。クリップはレンダリングされていません。 |
| UGC クリップが 1 本のクリップしかレンダリングしない。 | **クリップ**からの接続が**個別**モードになっていません。**個別**に戻してください。 |

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

`POST /v1/ugc/quote` は、UGC 動画の料金を算出します。無料で、何も確保されず、1 分あたり 30 回まで呼び出せます。形式は 2 つあります。

- **チケット：** `{ "tickets": [ … ], "hasCards": true }` は、UGC クリップ一覧が渡した 1〜11 本のクリップの料金を、UGC クリップとその後のステップでかかる額として算出します。これが UGC クリップ一覧に表示される金額です。
- **見積もり：** `{ "estimate": { "targetDurationSec": 15, "screenshotCount": 3, "source": "sampled" } }` は、何かを実行する前に、スクリプトとクリエイターを含む動画全体の料金を算出します。`targetDurationSec` は 4〜300 です。`screenshotCount` は 0〜8 で、1 と 2 は 0 として算出されます。`source` は `sampled`（AI クリエイター）または `photo` です。任意の `rendersEveryCandidate` を指定すると、エディターでの実行と同じく、すべてのクリエイター候補の料金を算出します。

チケットの形式は、任意のフィールドを 2 つ受け付けます。

- `finishes: true` は、ヘブライ語の動画のように、クリップが UGC 仕上げのジョブを通ることを示します。その場合、答えには「クリップの仕上げ」の行（キー `finish`）が含まれ、1 回だけ課金されます。結合の行（キー `join`）は、テンプレートの結合ノードの課金と同じように算出されます。つまり、その設定で、各クリップを「動画を結合」の標準の 8 秒の長さとして計算します。クリップは、クリップの長さを持たない 1 つのリストとして結合ノードに届くためです。
- `runEstimate` は、クリップが属する動画の見積もりの入力（`targetDurationSec`、`screenshotCount`、`source`、`language`）です。その場合、答えには `runHold` も含まれます。これは、その動画の見積もりがクリップとその後のステップのために確保する最大額で、同じ `hasCards` と `finishes` で算出されます。

どちらの形式も、`lines`（それぞれ英語の `label`、`credits`、固定の `key` を持つ）、`expected`、`ceiling`（クリップのレンダリング中に動画が保留する額）、`parts`、`holdParts` を返します。見積もりは、長さを 0.8 倍と 1.2 倍にしたときの見込みの料金である `range` と、`worstCase` も返します。料金を算出できない項目があると、`422 unpriceable` が返ります。UGC のルートが提供されていない環境では、このルートは `503 not_available` を返します。

ヘブライ語の動画（見積もりで `language: "he"`）では、録音した音声によってクリップの数が決まるため、見積もりには 0.8 倍と 1.2 倍の実行がありません。`expected` と `ceiling` は、音声に必要と見込まれるクリップの分です。`range` は、そうした音声に通常必要な最大数のクリップの分までです。`worstCase` には、受け入れられるどの録音を切り分けた場合でも最も高くなる切り分け方が、各クリップの料金の 2 倍で入ります。録音は目標の長さの最大 1.2 倍までで、21 秒を超えることはありません。15 秒の動画では 18 秒、17.5 秒以上の動画では 21 秒です。そのため、最悪の場合の額は目標の長さとともに増え、最長 7 秒のクリップ 6 本までになります。音声、単語のタイミング、分割、仕上げは、それぞれ独立した行で、1 回ずつ課金されます。

ヘブライ語の動画のクリップをレンダリングする前に、UGC クリップ一覧は `runEstimate` を付けてチケットの形式に問い合わせ、分割で渡されたクリップの料金を算出します。これは、エディターでも、公開したアプリでも、API での実行でも同じです。クリップの `ceiling` が `runHold` を上回る場合、または金額を得られない場合、どのクリップもレンダリングされる前に、実行は UGC クリップ一覧で止まります。

## よくある質問

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

UGC クリップ一覧は、UGC スクリプトのスクリプトと UGC クリエイターのクリエイターを受け取り、スクリプトをもう一度確認してから、テイクごとのクリップに分けます。その後、UGC クリップが各クリップをレンダリングします。

### UGC クリップ一覧にはクレジットがかかりますか？

いいえ。UGC クリップ一覧は無料です。表示される金額は、UGC クリップとその後のステップにかかる料金です。

### UGC 動画の料金をレンダリング前に確認するにはどうすればよいですか？

UGC スクリプト、UGC クリエイター、UGC クリップ一覧を、それぞれ自身の実行ボタンで 1 つずつ実行します。すると UGC クリップ一覧に、各クリップとその後の各ステップの行、「見込み」の合計、クリップのレンダリング中に保留される額が表示されます。

### UGC 動画のクリップは何本になりますか？

動画の長さと行によって決まります。UGC クリップ一覧には、クリップとそれぞれの長さが表示されます。動画が長いほど、クリップは多くなります。

### ヘブライ語の UGC の録音は、どのくらいの長さまでできますか？

ヘブライ語のスクリプトは、1 つの音声として録音されます。録音は動画の長さの最大 1.2 倍までで、21 秒を超えることはありません。それより長い録音では、実行が「SPEECH_TOO_LONG」で止まり、分割の料金は返還されます。

### クリエイターはどのボイスで話しますか？

「デフォルトのボイス」では、クリエイターに合ったボイスが選ばれます。設定パネルのボイスブラウザーから、好きなボイスを選ぶこともできます。