# UGC スクリプト

> 商品名または Web サイトと最大 8 枚のスクリーンショットから、UGC 動画の冒頭の行、パート、締めの行を書き、動画のルールに沿っているか確認します。

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

**UGC スクリプト**ノードは、UGC 動画でクリエイターが話す内容として、**冒頭の行**、**パート**、**締めの行**を書きます。最大 8 枚のスクリーンショットと、指定した商品名または Web サイトを読み取ります。スクリプトが動画のルールに沿っているか確認し、ルールに反していれば書き直します。

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

UGC スクリプトは、[**UGC クリエイター**](https://nodaro.ai/docs/nodes/video/ugc-creator)がクリエイターを描くための商品カテゴリも選びます。通常、次のノードは [**UGC クリップ一覧**](https://nodaro.ai/docs/nodes/video/ugc-clips)で、スクリプトをクリップに分けます。

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

## 使いどころ
- 商品や Web サイトについてクリエイターが話す、短い動画を作りたい。
- サイトやアプリのスクリーンショットがあり、クリエイターがそれに触れている間、各スクリーンショットをカードとして表示したい。
- 最初から動画の長さに合ったスクリプトがほしい。

画像プロンプト、セリフ、音楽のムードを含む複数シーンの脚本には、代わりに[**脚本生成**](https://nodaro.ai/docs/nodes/video/generate-script)を使ってください。

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

### 商品を指定する
[**テキスト**](https://nodaro.ai/docs/nodes/automate/text)ノードを**商品名または Web サイト**に接続します。商品名を入力するか、Web サイトを貼り付けます。

### スクリーンショットを追加する
3〜8 個の[**画像アップロード**](https://nodaro.ai/docs/nodes/image/upload-image)ノードを、クリエイターが話す順に**スクリーンショット 1**〜**スクリーンショット 8** に接続します。必要に応じて、商品の写真を**商品写真**に接続します。

### 長さを設定して実行する
設定パネルを開き、**動画の長さ（秒）**を設定します。**実行**をクリックします。スクリプトの行がノード上に表示されます。

Workflow: UGC スクリプトは、商品名とスクリーンショットからスクリプトを書きます。カテゴリは UGC クリエイターに、スクリプトは UGC クリップ一覧に渡されます。

- テキスト → UGC スクリプト (商品名または Web サイト)
- 画像アップロード → UGC スクリプト (スクリーンショット)
- UGC スクリプト → UGC クリエイター (カテゴリ)
- UGC スクリプト → UGC クリップ一覧 (スクリプト)
- UGC クリエイター → UGC クリップ一覧 (クリエイター)

## 入力
| 入力 | 必須 | 接続するもの |
| --- | --- | --- |
| **商品名または Web サイト** | はい | テキスト。80 文字までの名前は、入力したとおりのブランド名として使われます。300 文字までの長い説明は文脈として読み取られ、スクリプトはそこからブランド名を決めます。この入力がないと、ノードは「商品名または Web サイトを追加してください。」というメッセージで失敗します。 |
| **スクリーンショット 1**〜**スクリーンショット 8** | いいえ | 画像。カードの順に接続します。空の入力は飛ばされます。 |
| **商品写真** | いいえ | 商品の画像。商品写真があると、締めの行でクリエイターに商品を持たせることができます。 |

### スクリーンショットの枚数
- **3〜8 枚：** 入力の順に、スクリーンショット 1 から 1 枚につき 1 つのパートになります。各スクリーンショットは、クリエイターがそれについて話している間、カードとして表示されます。カードのタイミングは [**UGC カード**](https://nodaro.ai/docs/nodes/video/ugc-cards)が決めます。
- **1 枚か 2 枚**の場合は使われません。動画はクリエイターが話すだけでカードはなく、UGC カードのメモにそのことが書かれます。
- **0 枚：** 同じく、クリエイターが話すだけの動画になります。

UGC スクリプトは、スクリーンショットを画像として読み取ります。Web サイトにアクセスすることはありません。

## 出力
| 出力 | 内容 |
| --- | --- |
| **スクリプト** | スクリプトを表す JSON。[**UGC クリップ一覧**](https://nodaro.ai/docs/nodes/video/ugc-clips)の**スクリプト**入力に渡します。 |
| **カテゴリ** | 商品カテゴリを表すプレーンテキスト。[**UGC クリエイター**](https://nodaro.ai/docs/nodes/video/ugc-creator)の**商品カテゴリ**入力や、任意のテキスト入力に渡します。 |

## 設定
| 設定 | 内容 |
| --- | --- |
| **動画の長さ（秒）** | 動画の長さで、4〜300 秒です。デフォルトは 15 秒です。スクリプトはこの長さに合わせて書かれます。 |
| **言語** | スクリプトを書き、話す言語です。**英語**（デフォルト）または**ヘブライ語**です。ヘブライ語の動画では、クリップをつなぐ前に [**UGC 仕上げ**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips)が必要です。 |
| **このスクリプトを保持** | デフォルトはオフです。オンにすると、次の実行では書き直さずに前回のスクリプトをそのまま渡し、料金はかかりません。スクリプトを保持している間、長さは保持したスクリプト自体の長さのままです。長さを変えるには、**このスクリプトを保持**をオフにしてください。 |

設定には、スクリプトを何回で書いたかも表示されます。たとえば「2 回で作成」です。

### スクリプトの確認
UGC スクリプトは、スクリプトが動画のルールに沿っているか確認します。ルールに反していると、確認で見つかった内容をもとに書き直します。試すのは全部で 3 回、つまり最初の作成と最大 2 回の書き直しです。

### 行を編集する
実行のあと、設定にはスクリプトの行が表示されます。**冒頭の行**、各パート（**パート 1**、**パート 2** など）、**締めの行**です。

1. **編集**を押し、行の言葉を変えます。
2. **保存**を押すと、変更がスクリプトに書き込まれます。保存すると**このスクリプトを保持**がオンになり、次の実行ではあなたの行が使われます。
3. **キャンセル**を押すと、スクリプトは元のままです。

編集できるのは行の言葉だけです。空の行は、たとえば「パート 2 の行が空です。」というメッセージで拒否されます。スクリプトの文字数の上限を超える行も、たとえば「パート 2 の行が長すぎます。… 文字以内にしてください。」というメッセージで拒否されます。

[**UGC クリップ一覧**](https://nodaro.ai/docs/nodes/video/ugc-clips)は、クリップの料金がかかる前に、編集したスクリプトをもう一度確認します。ルールに反するスクリプトは、「スクリプトに修正が必要です：」に続けて各問題とその対処を示すメッセージで、UGC クリップ一覧を失敗させます。

### 公開したアプリでは
長さは、アプリの入力**動画の長さ（秒）**にできます。4〜300 秒のスライダーか、アプリで許可した長さからの選択になります。**サイトから作る UGC 動画**チュートリアルをアプリとして公開すると、15 秒、20 秒、25 秒から選べます。

## クレジット
UGC スクリプトは、書き直しの回数にかかわらず、1 回の実行につき固定の料金がかかります。エディターは、実行の前に**実行**ボタンに料金を表示します。

- 3 回試してもルールを満たせなかった実行のクレジットは返還されます。その実行は、「3 回試しても、スクリプトが動画のルールを満たせませんでした：」に続けて、まだ問題のある点を示すメッセージで失敗します。
- ほかの理由で失敗した実行のクレジットも返還されます。
- 保持したスクリプトは、料金なしで渡されます。その後のクリップの料金は、保持したスクリプト自体の長さとスクリーンショットカードに基づきます。

動画全体の料金については、[エディターでの料金](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor)を参照してください。

## ヒント
- **スクリーンショットは話す順にアップロードする。** カードの順番は、スクリーンショット入力の順番です。
- **気に入ったスクリプトを保持する。** **このスクリプトを保持**をオンにするか、行を編集して保存します。ワークフロー全体の次の実行では、新しいスクリプトの料金を払わずに、そのスクリプトが渡されます。
- **カードを使うには 3〜8 枚のスクリーンショットを使う。** それより少ないと、動画にカードは表示されません。
- **公開するとスクリプトは空になります。** **この実行結果を含める**を付けて公開したテンプレートでは、テンプレートをコピーした人が最初のスクリプトを作るまで、話す行が例として表示されます。

## トラブルシューティング
| メッセージまたは問題 | 原因と対処 |
| --- | --- |
| 「商品名または Web サイトを追加してください。」 | **商品名または Web サイト**に何も接続されていません。名前か Web サイトを入れた「テキスト」ノードを接続してください。 |
| 「3 回試しても、スクリプトが動画のルールを満たせませんでした：」 | 2 回書き直しても、スクリプトがまだルールに反していました。実行のクレジットは返還されます。長さ、商品のテキスト、スクリーンショットを変えて、もう一度実行してください。 |
| 「パート 2 の行が空です。」 | 編集した行が空です。行を書くか、**キャンセル**を押してください。 |
| 「パート 2 の行が長すぎます。… 文字以内にしてください。」 | 編集した行が上限を超えています。短くしてください。 |
| 長さの設定を変えられない。 | **このスクリプトを保持**がオンです。長さを変えるにはオフにしてください。 |
| 動画にカードがない。 | 接続したスクリーンショットが 3 枚未満です。3〜8 枚のスクリーンショットを追加してください。 |

## API から
UGC スクリプトは、実行時に `POST /v1/ugc/script` を呼び出し、このルートはジョブ ID を返します。UGC のルートのリクエストとレスポンスの形はノードのためのもので、バージョンによって変わる場合があります。コードから UGC 動画を作るには、UGC ノードを含むワークフローか公開したアプリを実行してください。

実行リクエストでは、UGC スクリプトの `targetDurationSec` を 4〜300 の範囲で設定できます。UGC ノードでは、ほかに UGC クリエイターの `source`、`gender`、`photoUrl` だけを設定できます。UGC ノードのそれ以外の項目を指定すると、`400 locked_field` が返ります。[ワークフロー](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values)と[ミニアプリ](https://nodaro.ai/docs/concepts/apps#embed-a-miniapp-or-run-it-from-code)を参照してください。

MCP で接続した AI アシスタントは、`build_ugc_clips` などの専用の UGC ツールを使います。`get_recipe` で読み込む ugc-website レシピに、その使い方が書かれています。[コンテンツレシピ](https://nodaro.ai/docs/mcp/recipes)を参照してください。

## よくある質問

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

UGC スクリプトは、UGC 動画でクリエイターが話す内容として、冒頭の行、パート、締めの行を書きます。商品名または Web サイトと最大 8 枚のスクリーンショットを読み取り、スクリプトが動画のルールに沿っているか確認します。

### UGC スクリプトは私の Web サイトにアクセスしますか？

いいえ。UGC スクリプトはスクリーンショットを画像として読み取るだけで、Web サイトにはアクセスしません。商品名を入力するか、Web サイトを文脈として貼り付けてください。

### スクリーンショットは何枚アップロードすればよいですか？

3〜8 枚をアップロードしてください。各スクリーンショットに 1 つのパートが割り当てられ、クリエイターがそれについて話している間、カードとして表示されます。1 枚か 2 枚、または 0 枚の場合、動画はクリエイターが話すだけで、カードはありません。

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

UGC スクリプトは、書き直しの回数にかかわらず、1 回の実行につき固定の料金がかかります。失敗した実行のクレジットは返還され、保持したスクリプトには料金がかかりません。エディターは、実行の前に料金を表示します。

### スクリプトを編集できますか？

はい。実行のあと、設定パネルで「編集」を押し、行の言葉を変えて「保存」を押します。保存すると「このスクリプトを保持」がオンになり、次の実行ではあなたの行が使われます。