mcpField
A
Agent-Media UGC Playbook

Agent-Media UGC Playbook

github.com/gitroomhq创意与媒体83122 次安装3 天前更新
代码仓库

关于 Agent-Media UGC Playbook

Agent-Media UGC Playbook 面向需要制作 UGC 视频的 Agent，通过一次 `make_ugc` 调用生成成片。它支持短片、长篇独白和配音素材视频，也可选发布到社交平台。

主要功能

  1. 01单次调用生成视频
  2. 02支持短片和长篇独白
  3. 03为提供的素材视频配音
  4. 04复用角色和人物形象
  5. 05可选发布到社交平台

适用场景

  1. 01根据短脚本制作口播短片
  2. 02生成完整的口述独白视频
  3. 03为产品或游戏画面配音
  4. 04将成片发布到社交平台

MCP 相关

该技能可通过 `social_publish` MCP 工具发布视频；视频生成请求则通过 API 工作流说明。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gitroomhq/agent-media --skill agent-media-ugc-playbook

安装后在 Claude Code 中输入/agent-media-ugc-playbook确认已加载。

详细介绍

Agent-Media UGC 操作手册

你是一个需要在 agent-media 上制作完整 UGC 视频的 Agent（Claude、Cursor、自定义 Agent）。只有一个工具——make_ugc（Agent-Media UGC Video）。你无需选择子技能；make_ugc 会解析身份信息，并在内部运行整个流程。

一个工具，三种用法

你的需求提供给 make_ugc 的内容结果
短片段一行 script（+ 可选的 person/image/character）一段干净的对镜口播片段
完整独白较长的 script（+ 通过 image 或 character 提供真实人脸）无缝衔接的多镜头视频，不会被剪短
带旁白的 B-roll 评论视频script + broll_url + character/image人物在你的素材上进行旁白解说

如何调用

只需调用一次。服务会选择工作流、镜头数和时长，在一个 Temporal 工作流中运行，并返回供你轮询的 skill_run_id。

POST https://api.agent-media.ai/v1/skills/make_ugc/run
Authorization: Bearer $AGENT_MEDIA_API_KEY

{
  "script": "Okay this is wild, I tried the new flow and it actually works.",
  "person": "a friendly young woman, soft daylight, candid framing",
  "name": "Maya, 27"
}

使用 GET /v1/skills/runs/<skill_run_id> 轮询，直到 status 为 succeeded；final_output.video_url 就是生成的 MP4 视频。

有关完整字段手册，请参阅 skills/make-ugc/SKILL.md。

步骤 D — 发布视频（可选）

获得 video_url 后，你可以通过 publish-to-social 技能，将视频直接发布到用户的 TikTok / Instagram / X——使用 POST /v1/social/publish（CLI agent-media social publish，MCP social_publish）。用户只需通过 OAuth 连接一次各社交平台（/v1/social/connect）。参阅 skills/publish-to-social/SKILL.md。

身份信息

  • person — 用文字描述人物；image — 照片（https URL 或 base64）；character — 已保存的 char_… ID，或通过 list_characters 获取的 character_sheet_url；三者都省略时使用默认人物。
  • 完整独白或 B-roll 评论视频需要真实人脸——请传入 image 或 character，而不只是 person。
  • 重用已保存的人物：在下一次调用时传入相同的 character，无需重新生成。

规则

  • make_ugc 会为你控制节奏并拆分脚本——请传入完整的一句台词或独白，切勿自行删减。系统会根据脚本推断时长。
  • 传入的任何图片/视频 URL 都必须是公开的 https URL（make_ugc 会为你将其重新托管到 R2），或者是已保存人物的 character_sheet_url / char_…。
  • 每个镜头运行时都会扣除积分。视频中的肖像和人物设定表准备均免费——你只需为视频本身付费。
  • 描述中不要写“selfie”或“phone”——请改用“talking to camera”。make_ugc 已在内部处理这些内容。

故障排除

  • INSUFFICIENT_CREDITS — 用户积分不足。提供 agent-media.ai 账单页面链接。
  • make_ugc_needs_face — 完整独白或 B-roll 评论视频需要 image 或 character（真实人脸），不能只提供 person。
  • 视频中的人物手持手机 — 他们使用了提及“selfie”或“phone”的姿势提示。请删除该提示，或设置 pose: ""。
  • 步骤卡在 submitted — Temporal worker 可能正在重启。等待 30 秒后重新轮询；如果 5 分钟后仍未完成，则工作流已挂起——请联系 agent-media 支持并提供 workflow_id。

另请参阅

评论

支持 Markdown