# UGC カード

> UGC 動画のスクリーンショットカードと字幕のタイミングを、クリエイターの話し声に合わせます。各クリップが行を話したかを確認し、実行についてのわかりやすいメモを書きます。

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

**UGC カード**ノードは、UGC 動画のスクリーンショットカードと字幕のタイミングを、クリエイターの話し声に合わせます。対象は結合した動画、つまり [**UGC クリップ**](https://nodaro.ai/docs/nodes/video/ugc-clip)のクリップを[**動画を結合**](https://nodaro.ai/docs/nodes/video/combine-videos)でつないだものです。各クリップが行を話したかも確認し、**メモ**を書きます。

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

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

- **スクリーンショットカード。** 各スクリーンショットは、クリエイターがそれについて話している間に表示されます。カードは、[**動画オーバーレイ**](https://nodaro.ai/docs/nodes/video/video-overlay#layer-plan-input)のためのレイヤープランとして出力されます。
- **字幕。** プランには、冒頭の行、その終わる位置、残りのタイミング付きの単語が含まれます。字幕は、[**字幕を追加**](https://nodaro.ai/docs/nodes/video/add-captions#caption-plan-input)のためのキャプションプランとして出力されます。字幕を追加は、冒頭の行をフックプレートのルックで、残りを自身の字幕スタイルで描きます。

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

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

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

### 入力を接続する
UGC クリップ一覧の**スクリプト（長さ調整済み）**出力と**文字起こし**出力を、**スクリプト**と**文字起こし**に接続します。動画を結合で結合した動画を**動画**に接続します。UGC クリップの**動画**出力を**クリップのメモ**に接続します。

### プランを接続する
**レイヤープラン**を動画オーバーレイの**レイヤープラン**入力に接続します。**キャプションプラン**を字幕を追加の**キャプションプラン**入力に接続します。

### 実行してメモを読む
ワークフローを実行します。ノード上か設定パネルでメモを読みます。

Workflow: UGC カードは、結合した動画とクリップのメモを読み取ります。動画オーバーレイがスクリーンショットカードを描き、字幕を追加がその結果に字幕を描きます。

- UGC クリップ一覧 → UGC カード (スクリプト（長さ調整済み）)
- UGC クリップ → 動画を結合 (一括)
- UGC クリップ → UGC カード (クリップのメモ)
- 動画を結合 → UGC カード (動画)
- UGC カード → 動画オーバーレイ (レイヤープラン)
- 動画オーバーレイ → 字幕を追加 (動画)

## 入力
| 入力 | 必須 | 接続するもの |
| --- | --- | --- |
| **スクリプト** | はい | UGC クリップ一覧の**スクリプト（長さ調整済み）**出力。それ以外を接続すると、どちらのタイミングのジョブも始まる前に、ノードは「「UGC クリップ一覧」の「スクリプト（長さ調整済み）」出力を接続してください。」というメッセージで失敗します。 |
| **動画** | はい | 動画を結合で結合した動画。接続しないと、ノードは「結合した動画を接続してください。」というメッセージで失敗します。 |
| **文字起こし** | はい | UGC クリップ一覧の**文字起こし**出力。接続しないと、ノードは「「UGC クリップ一覧」の「文字起こし」出力を接続してください。」というメッセージで失敗します。 |
| **クリップのメモ** | いいえ | UGC クリップの**動画**出力。UGC カードは、各クリップの警告と実際の長さを読み取ります。ボイスに合わせて長くなったクリップは、話し声の確認の範囲をずらします。この入力がないと、メモにはクリップについて何も書かれません。 |

## 出力
| 出力 | 内容 |
| --- | --- |
| **レイヤープラン** | スクリーンショットカードを表す JSON。動画オーバーレイの**レイヤープラン**入力に渡します。 |
| **キャプションプラン** | 字幕を表す JSON。字幕を追加の**キャプションプラン**入力に渡します。 |
| **メモ** | プレーンテキストで、1 行に 1 文です。公開したアプリでは、メモはテキストの出力になります。 |

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

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

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

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

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

| 状況 | 文 |
| --- | --- |
| スクリーンショットがない、または 1 枚か 2 枚だけで、スクリプトがそれを使わない | スクリーンショットカードはありません。動画はクリエイターが話すだけです。カードを表示するには、3〜8 枚のスクリーンショットを追加してください。 |
| 単語アライメントが失敗した、または単語が見つからなかった | 字幕とカードのタイミングは、音声認識で取りました。 |
| 文字起こしが失敗した、または単語が聞き取れなかった | 話し声の確認は行われませんでした。話し声を文字起こしできませんでした。 |
| 動画のクリップの区切りがわからず、どのクリップの言葉も確認できなかった | 話し声の確認は行われませんでした。動画のクリップの区切りがわかりませんでした。 |
| 何もタイミングを取れなかった | カードも字幕もありません。話し声のタイミングを取れませんでした。 |
| カードが締めの行に重なるところだった | カード *n* は締めの行に重なるため、除外しました。 |
| クリップが確認に 2 回通らなかった | クリップ *n* は、1 回再レンダリングしたあとも問題が残りました（*確認で見つかった内容*）。UGC クリップノードから再レンダリングしてください。 |
| クリップが確認に通らず、再レンダリングする余裕が残っていなかった | クリップ *n* に問題がありました（*確認で見つかった内容*）が、再レンダリングする余裕が残っていませんでした。UGC クリップノードから再レンダリングしてください。 |
| クリップの再レンダリングが失敗した | クリップ *n* の再レンダリングが失敗したため、最初のレンダリングを保持しました。 |
| クリップの自動確認を実行できず、確認なしでクリップを保持した | クリップ *n* は自動確認なしで保持しました。今回は確認を実行できませんでした。再生して確かめ、おかしいところがあれば UGC クリップノードから再レンダリングしてください。 |
| クリップの話し声が行と一致しなかった | クリップ *n* は行をそのとおりに話していない可能性があります。聞き取られた内容：「*聞き取られた内容*」 |
| ボイスに合わせてクリップが長くなった | クリップ *n* は、ボイスに合わせて長くしました。 |
| 問題がなく、すべての確認が実行された | 問題はありません。 |

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

- 単語アライメントのジョブ 1 回。[**強制アライメント**](https://nodaro.ai/docs/nodes/audio/forced-alignment)の料金で、33 クレジットです。
- 文字起こしのジョブ 1 回。そのジョブ自体の料金で請求されます。

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

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

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

## トラブルシューティング
| メッセージまたは問題 | 原因と対処 |
| --- | --- |
| 「「UGC クリップ一覧」の「スクリプト（長さ調整済み）」出力を接続してください。」 | **スクリプト**が空か、UGC スクリプトなど別のノードの出力が接続されています。UGC クリップ一覧の**スクリプト（長さ調整済み）**出力を接続してください。 |
| 「結合した動画を接続してください。」 | 動画を結合で結合した動画を**動画**に接続してください。 |
| 「「UGC クリップ一覧」の「文字起こし」出力を接続してください。」 | UGC クリップ一覧の**文字起こし**出力を**文字起こし**に接続してください。 |
| 動画にカードがない。 | UGC スクリプトに接続したスクリーンショットが 3 枚未満です。3〜8 枚のスクリーンショットを追加してください。 |
| 動画にカードも字幕もない。 | 話し声のタイミングを取れませんでした。メモにそのことが書かれます。結合した動画にクリエイターの話し声が入っているか確認してください。 |
| メモにクリップについて何も書かれない。 | UGC クリップの**動画**出力を**クリップのメモ**に接続してください。 |

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

API からの実行の結果では、メモは UGC カードの `text` です。[ワークフロー](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values)と[実行](https://nodaro.ai/docs/developers/api/executions)を参照してください。

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

## よくある質問

### UGC カードノードは何をしますか？

UGC カードは、結合した UGC 動画で各単語が話されるタイミングを見つけます。それをもとに、動画オーバーレイのためのスクリーンショットカードと、字幕を追加のための字幕のタイミングを決めます。各クリップの話し声も確認し、メモを書きます。

### UGC カードには何クレジットかかりますか？

UGC カード自体に料金はありません。結合した動画に対して、単語アライメントのジョブと文字起こしのジョブを 1 回ずつ実行し、それぞれの料金で請求されます。

### メモとは何ですか？

メモは、予定どおりに進まなかったことを、1 行に 1 文ずつ書いたわかりやすい文です。たとえば、行をそのとおりに話していない可能性のあるクリップについて書かれます。問題がなく、すべての確認が実行された場合は「問題はありません。」と書かれます。

### UGC 動画にスクリーンショットカードがないのはなぜですか？

カードが表示されるのは、UGC スクリプトのスクリーンショットが 3〜8 枚の場合だけです。0 枚、または 1 枚か 2 枚の場合、動画はクリエイターが話すだけになり、メモにそのことが書かれます。

### 話し声のタイミングを取れなかった場合はどうなりますか？

どちらのプランも空になります。動画オーバーレイと字幕を追加は動画をそのまま料金なしで通し、メモには話し声のタイミングを取れなかったことが書かれます。