UGC スクリプト

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

UGC スクリプトは、UGC クリエイターがクリエイターを描くための商品カテゴリも選びます。通常、次のノードは UGC クリップ一覧で、スクリプトをクリップに分けます。

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

使いどころ

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

画像プロンプト、セリフ、音楽のムードを含む複数シーンの脚本には、代わりに脚本生成を使ってください。

クイックスタート

入力

スクリーンショットの枚数

• 3〜8 枚： 入力の順に、スクリーンショット 1 から 1 枚につき 1 つのパートになります。各スクリーンショットは、クリエイターがそれについて話している間、カードとして表示されます。カードのタイミングは UGC カードが決めます。
• 1 枚か 2 枚の場合は使われません。動画はクリエイターが話すだけでカードはなく、UGC カードのメモにそのことが書かれます。
• 0 枚： 同じく、クリエイターが話すだけの動画になります。

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

出力

設定

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

スクリプトの確認

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

行を編集する

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

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

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

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

公開したアプリでは

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

クレジット

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

• 3 回試してもルールを満たせなかった実行のクレジットは返還されます。その実行は、「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 が返ります。ワークフローとミニアプリを参照してください。

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