UGC カード

UGC カードノードは、UGC 動画のスクリーンショットカードと字幕のタイミングを、クリエイターの話し声に合わせます。対象は結合した動画、つまり UGC クリップのクリップを動画を結合でつないだものです。各クリップが行を話したかも確認し、メモを書きます。

UGC カードは、各単語が話されるタイミングを見つけます。それをもとに、次の 2 つのタイミングを決めます。

• スクリーンショットカード。 各スクリーンショットは、クリエイターがそれについて話している間に表示されます。カードは、動画オーバーレイのためのレイヤープランとして出力されます。
• 字幕。 プランには、冒頭の行、その終わる位置、残りのタイミング付きの単語が含まれます。字幕は、字幕を追加のためのキャプションプランとして出力されます。字幕を追加は、冒頭の行をフックプレートのルックで、残りを自身の字幕スタイルで描きます。

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

使いどころ

• UGC 動画のクリップをつなぎ、スクリーンショットカードと字幕のタイミングを話し声に合わせたい。
• 実行についてのわかりやすい文から、どのクリップを再レンダリングすべきか知りたい。

クイックスタート

入力

出力

設定

UGC カードには設定がありません。設定パネルには、前回の実行のメモが表示されます。

単語のタイミングの取り方

単語のタイミングは、クリップの言葉を結合した動画に対してアライメントすることで得られます。

• アライメントが失敗するか、単語が見つからない場合は、代わりに音声認識でカードと字幕のタイミングを取ります。
• 文字起こしが失敗するか、単語が聞き取れなかった場合、話し声の確認は行われません。
• 動画のクリップの区切りがわからない場合も、話し声の確認は行われません。
• 何もタイミングを取れない場合、どちらのプランも空になります。動画オーバーレイと字幕を追加は、動画をそのまま料金なしで通します。

どれが起きたかは、メモに書かれます。

メモ

「問題はありません。」が表示されるのは、問題がなく、すべての確認（各クリップ自身の確認と話し声の確認）が実行された場合だけです。実行されなかった確認には、必ずそれぞれの文が付きます。

クレジット

UGC カード自体に料金はありません。結合した動画に対して 2 つのジョブを実行し、それぞれの料金で請求されます。

• 単語アライメントのジョブ 1 回。強制アライメントの料金で、33 クレジットです。
• 文字起こしのジョブ 1 回。そのジョブ自体の料金で請求されます。

クレジットが両方のジョブをまかなえない場合、ノードは通常のクレジット不足の拒否で止まります。字幕なしでカードだけが作られることはありません。ノードはまず、UGC のルートが提供されているかを料金なしで確認するため、提供されていない環境で料金がかかることはありません。

エディターは、実行の前に実行全体の料金を表示します。エディターでの料金を参照してください。

ヒント

• 実行のたびにメモを読む。 行をそのとおりに話していない可能性のあるクリップや、問題が残ったクリップは、UGC クリップで再レンダリングすべきものです。
• UGC クリップをクリップのメモに接続する。 接続しないと、メモにはクリップについて何も書かれません。
• 公開してもカードやメモは含まれません。 この実行結果を含めるを付けて公開したテンプレートでは、カードとメモが例として表示されます。

トラブルシューティング

API から

UGC カードは、実行時に POST /v1/ugc/cards を呼び出します。最初の呼び出しは GET /v1/ugc/categories で、これは無料で、UGC のルートが提供されているかを確認します。UGC のルートのリクエストとレスポンスの形はノードのためのもので、バージョンによって変わる場合があります。コードから UGC 動画を作るには、UGC ノードを含むワークフローか公開したアプリを実行してください。

API からの実行の結果では、メモは UGC カードの text です。ワークフローと実行を参照してください。

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