UGC クリエイター

UGC クリエイターノードは、UGC 動画でカメラに向かって話す人物を決めます。商品に合わせて描く AI クリエイターか、自分の写真です。クリエイターは UGC クリップ一覧に渡され、動画のすべてのクリップにこの人物が映ります。

UGC クリエイターは、6 つの UGC 動画ノードの 1 つです。UGC スクリプト、UGC クリップ一覧、UGC クリップ、UGC 仕上げ、UGC カードと組み合わせて、クリエイターが商品について話し、そのあいだにスクリーンショットがカードとして表示される、字幕付きの動画を作ります。

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

クリエイターは成人に限られます。クリエイターの見た目に接続した「人物」ピッカーが 20 歳未満の年齢を設定すると、「その年齢は使用できません。UGC のクリエイターは成人に限られます。」というメッセージで拒否されます。成人の年齢が設定されていない状態で、未成年を示すタイプを指定した場合も同じです。写真には、顔がはっきり写った成人がちょうど 1 人写っている必要があります。

使いどころ

• UGC 動画を作るときに、商品に合った AI クリエイターがほしい。
• 1 枚の写真から、自分自身で動画に出演したい。
• 気に入ったクリエイターが見つかったので、以降のすべての動画で同じ人物を使いたい。

クイックスタート

入力

出力

候補があなたの選択を待っている間は、ノードから何も出力されません。

設定

エディターでは、自分の写真の写真はあなたの写真入力から渡してください。写真がないと、ノードは「自分の写真を接続するか、アップロードしてください。」というメッセージで失敗します。アップロードするのは、自分の写真か、同意を得た人の写真だけにしてください。

AI クリエイターの描き方

AI クリエイターは、商品カテゴリ、選んだ性別、クリエイターの見た目のピッカーで設定した項目に合わせて描かれます。描くたびに別の人物になります。新しいクリエイターは、ピッカーで固定していない限り、年齢、髪の色、髪型、体格のうち少なくとも 2 つが、前回見たクリエイターと異なります。

• エディターでは、ノードはいくつかの候補を描き、あなたが 1 つを選ぶまで、実行は UGC クリエイターで止まります。
• 公開したアプリや API からの実行では、ノードはクリエイターを 1 人だけ描き、実行はそのまま続きます。
• サブワークフローの中や、リストの項目ごとの実行では、同じようにクリエイターを 1 人だけ描き、実行はそのまま続きます。

候補が 1 つしかできなかった場合、ノードは確認せずにその候補を使います。

クリエイターを選ぶ

候補はノード上に並んで表示され、候補 1、候補 2 のようにラベルが付きます。

• これを使うは、その候補を保持し、このクリエイターを保持をオンにします。次に、UGC クリエイターのここから実行を押すと、動画が作られます。
• 新しい候補を表示は、描き直します。新しい候補は、すでに見た候補とは異なります。保持しているクリエイターがある状態で新しい候補を表示を押すと、このクリエイターを保持がオフになり、ノードが実行されます。

候補が選択を待っている間、UGC クリエイターを含む実行は「先にクリエイターを選んでください。」というメッセージで拒否されます。一部の候補を作れなかった場合でも、ほかの候補はメモ付きで表示されます。

クレジット

UGC クリエイター自体に料金はありません。実行で請求されるのは次のとおりです。

• 描く画像はそれぞれ通常の画像ジョブで、その画像モデルの料金で請求されます。
• 各画像は確認されます。 人物が選んだ性別と一致するかを、1 回の画像読み取りで確認します。
• エディターでは、すべての候補を描いて確認します。公開したアプリや API からの実行では、クリエイターを 1 人だけ描いて確認します。
• 写真は、1 回の画像読み取りで確認されます。確認に通らない写真は、「この写真は使用できません。顔がはっきり写った成人がちょうど 1 人写っている必要があります。」というメッセージで拒否されます。
• 保持したクリエイターは、料金なしで渡されます。

モデレーションによって 1 回の描画のすべての画像がブロックされた場合、代わりに画像をもう 1 枚、その画像自体の料金で描き、同じように確認します。

確認に通る候補が 1 つもない場合、クリエイターをもう一度、同じ料金で描きます。その描画も失敗すると、クリップをレンダリングする前に実行が止まります。メッセージは「AI クリエイターが、選んだ人物として描かれませんでした。「UGC クリエイター」をもう一度実行してください。」です。UGC スクリプトがすでに書いたスクリプトの料金は請求されます。

描画中にクレジットがなくなると、ノードは止まります。エディターではクレジット購入のダイアログが開き、すでに確認済みの候補はノードに残るので、そこから選べます。

実行の前に、エディターはクリエイターの料金を動画のほかの部分とまとめて表示します。エディターでの料金を参照してください。

ヒント

• ピッカーで見た目を調整する。 年齢、髪、体格には「人物」、メイク、髪型、服装には「スタイリング」、クリエイターが撮影する場所には「舞台設定」、光には「ライティング」を使います。
• クリエイターの見た目を空のままにすると、商品カテゴリだけに合わせてクリエイターが描かれます。
• 気に入ったクリエイターを保持する。 これを使うを押すと、以降のすべての実行で、同じ人物を料金なしで使います。
• あなたの写真は非公開のままです。 公開したアプリやテンプレートに、あなたの写真が含まれることはありません。自分の写真に設定したアプリでは、実行する人それぞれに自分の写真を求めます。

トラブルシューティング

API から

UGC クリエイターは、実行時に POST /v1/ugc/creator を呼び出します。UGC のルートのリクエストとレスポンスの形はノードのためのもので、バージョンによって変わる場合があります。コードから UGC 動画を作るには、UGC ノードを含むワークフローか公開したアプリを実行してください。API からの実行では、クリエイターを 1 人だけ描き、選択を待つことはありません。

実行リクエストで設定できる UGC クリエイターの項目は、source（AI クリエイターなら sampled、自分の写真なら photo）、gender（woman または man）、photoUrl の 3 つだけです。UGC ノードのそれ以外の項目を指定すると、400 locked_field が返ります。ワークフローとミニアプリを参照してください。

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