Agent-Media UGC Video

Agent-Media UGC Video

1つのツール。1回の呼び出し。完成済みの字幕付き縦型UGC動画。

script と、（任意で）話し手を指定するだけで、agent-media がパイプライン、テイク数、動画の長さを選びます。サブツールを選ぶ必要はありません。

• 短いセリフ → すっきりとしたトーキングヘッドのクリップ1本。
• 完全なモノローグ（長さは問いません） → 途切れのない複数テイクの動画。クリップに収まるようにトリミングされることはありません。
• broll_url → 人物が、指定したBロール／ゲームプレイ／製品の映像にナレーションを重ねます。

入力

話す内容 — 次のいずれか1つだけです。

• script — 話すセリフ。長さは問いません。 1文ならクリップ1本、段落なら複数テイクの完全な動画になります。トリミングされることはありません。
• scene_action — 代わりに無音のクリップ（ダンス、Bロール、雰囲気など）を作成します。character が必要です。

話し手 — 任意。指定する場合は1つまでです（省略すると、デフォルトの人物が生成されます）。

• person — "a 25-year-old woman with curly red hair" のように、人物の特徴を文章で指定します。
• image — 人物の写真。公開されている https URL または base64を指定します。顔はその写真に固定されます。
• character — 保存済みキャラクターを再利用します。list_characters で取得した char_… ID、または character_sheet_url を指定します。
• name — 任意の名前／年齢／雰囲気のヒント。例："Sophia, 28"。

長いモノローグや**broll_url**を使ったレビューには、実在する人物の顔が必要です。person だけではなく、image または character を指定してください。

字幕はオプトインです。独断で追加しないでください。 まず、字幕が必要か、どの caption_style（hormozi | tiktok | minimal）にするかをユーザーに尋ねてください。希望すると回答した場合にのみ captions:true を設定し、それ以外の場合は無効のままにします。

見た目と形式 — すべて任意です。

• captions — true に設定しない限り無効（上記のとおり、先に確認してください）。caption_style（hormozi | tiktok | minimal）
• look（natural | commercial | raw_iphone）、aspect_ratio（9:16 | 1:1）
• broll_url — ナレーション中、画面下半分に重ねる https 動画。
• duration — 空欄のままにしてください。長さはスクリプトから推定されます。短いクリップを強制する場合にのみ設定します。

例

テキストの説明から短いクリップを作成：

{ "script": "Honestly? This app saved my whole morning routine.", "person": "a friendly young woman, soft daylight" }

保存済みキャラクターから完全なモノローグを作成 — 複数テイク、トリミングなし：

{ "script": "Okay I have to be honest with you for a second. Three months ago I was completely overwhelmed … (the entire monologue, as long as you like) … and that is your sign.", "character": "char_8f3ac210" }

実在する人物の写真から作成：

{ "script": "Wait — you have to see what this actually does.", "image": "https://example.com/face.jpg", "name": "Maya, 27" }

ナレーション付きのBロール／ゲームプレイレビュー：

{ "script": "Watch this play — this is where the whole match turns around.", "broll_url": "https://example.com/clip.mp4", "character": "char_8f3ac210" }

セッション中に同じ人物を再利用する

動画が完成すると、キャラクターが保存されます — GET /v1/characters で、character_id（char_…）と character_sheet_url を確認できます。同じタスク内で次の動画を作成する際は、新しい person ではなく、その値を character に指定してください。同じ顔が正確に維持され、既存のポートレートとキャラクターシートを再利用するため、より速く、より安価です（キャラクターシートが省略されることはなく、再利用されます）。ユーザーが別の人物を希望した場合にのみ、新しい人物を生成してください。同じ人物か新しい人物か判断できない場合は、生成する前にユーザーに確認してください。**

呼び出し方法

推奨方法：MCP ツール mcp__agent-media__make_ugc。完全なスキーマは tools/list を通じて自動公開されます。上記のフィールドは手動で指定します。

代替方法：REST。

POST https://api.agent-media.ai/v1/skills/make_ugc/run
Authorization: Bearer $AGENT_MEDIA_API_KEY
Content-Type: application/json
Idempotency-Key: <any unique string per intent>

{ "script": "Okay this completely changed how I work — I plan my whole week in ten minutes now.", "character": "char_8f3ac210" }

コストと所要時間

• クレジット：route-dependent: ~190–505 for a short clip; priced per-take for a long monologue or b-roll review
• 処理時間（通常）：360–1400s
• 各テイクの処理に応じて差し引かれます。

結果のポーリング

GET https://api.agent-media.ai/v1/skills/runs/<skill_run_id>
Authorization: Bearer $AGENT_MEDIA_API_KEY

各ステップの status と current_step が返されます。status が succeeded の場合、final_output.video_url が完成した MP4 です。

ユーザーに状況を伝え、無言にならないでください。 動画の作成には数分かかります。新しい人物を使う場合は、ポートレート → キャラクターシート → 動画（→ 希望された場合は字幕）の順に進みます。保存済みの人物を再利用する場合は、すぐに動画の作成に進みます。リクエストを送信したら、作業内容とおおよその所要時間をユーザーに伝えてください。その後、ポーリングを行い、current_step が変わるたびに状況を報告してください（例：「キャラクターシートを作成しています…」「動画をレンダリングしています…」「字幕を追加しています…」）。これにより、ユーザーは常に進行状況を把握できます。

運用ルール

• すべてのプロンプトに組み込まれているリアリズムの原則については、reference/realism-rubric.md を参照してください。
• reference/pacing.md を参照してください。ペース配分を管理する必要はありません。make_ugc が言葉数に合わせて各テイクの長さを調整します。
• 初回インストールと agent-media login については、reference/auth.md を参照してください。

信頼できる情報源

scripts/generate-public-skill.ts が services/api-v2/src/skills/registry.ts から自動生成します。手動で編集しないでください。CI で差分が検出されると拒否されます。