openclip-ugc-ads

OpenClip：UGC 广告生成

generate_ugc 根据创意简报生成一段简短的竖屏 UGC 风格视频（约 7 到 12 秒）。免费账户每天可生成一次。付费账户按渲染秒数扣除点数。

渲染过程很耗时。每段视频需要几分钟，而不是几秒钟。

设置（仅需一次）

OpenClip 是一个远程 MCP 服务，地址为 https://openclip.app/mcp。出现 OAuth 提示时，使用你的 OpenClip 账户登录，无需复制 API 密钥。

• Claude Code： claude mcp add --transport http openclip https://openclip.app/mcp，然后运行 /mcp 进行授权。
• Claude Desktop / web： 打开设置，进入连接器，选择“添加自定义连接器”，粘贴 URL 并登录。
• Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• 仅支持请求头的客户端： 在 openclip.app/settings/connect 创建 MCP 令牌，然后使用 Authorization: Bearer <token> 连接到 https://openclip.app/mcp/key。

快速检查：调用 get_account。

工作流程

1. 先发现创作者名单。 list_ugc_creators 会返回此团队可用的 creator 和 start_frame 值：包括精选名单，以及团队自己保存的创作者，并按细分领域分组。不要猜测创作者名称，应从此次调用的结果中选择。
2. 生成。 使用 generate_ugc(...)，并选择以下其中一种方式：
   • brief_name——服务端预设，是最快捷的方式；或
   • brief——包含结构化创意字段（character 等）的内联对象。
3. 轮询。 返回一个 ugc_job hashid。每隔 10 到 15 秒调用一次 get_ugc_job_status(ugc_job)。queued / rendering 表示任务正在进行。completed 会返回 video_url 和 result_meta（时长、尺寸、fps、seed）。failed 会返回 error。
4. 查看过往作品。 list_ugc_jobs 会列出团队以往的 UGC 视频；如果你丢失了 ugc_job ID，可通过它找到 ID 并进行轮询。

简报是结构化数据，不是提示词

这是 Agent 最容易弄错的地方。brief 不是一段散文提示词，而是由离散创意字段（character 及 API 接受的其他字段）组成的对象。把一段话写进某个字段会浪费结构化字段的作用，生成的内容也会变得含糊杂乱。

每个字段都应填写具体、可见、可拍摄的细节：

• 写明画面中有什么，而不是描述画面应给人什么感觉。“手持瓶子置于胸前高度，背景是厨房台面”胜过“充满活力、令人向往的氛围”。
• 每个字段只表达一个想法。不要把三个情节点塞进 character。
• 具体限制比形容词更能提升效果。明确的场景、道具和动作，胜过“高质量、专业、吸引人”。

测试广告角度

如果用户想要多个版本，而不是单条视频，每次渲染只更改一个变量，这样比较才有意义：

• 创作者相同，钩子不同。
• 测试谁最能传达信息时，钩子相同，创作者不同。
• 测试缩略图画面时，其他条件相同，只更改 start_frame。

免费账户每天只能生成一次，因此在免费账户上，应把额度用于差异最大的角度，而不是近乎重复的版本。承诺批量生成前，先检查 get_account。

规则

• 每个会话中的首次生成前，都要调用 list_ugc_creators。名单因团队而异，并且会变化。
• 始终进行轮询。渲染需要几分钟，而 generate_ugc 会立即返回。
• 视频按设计就是短片，时长约为 7 到 12 秒。不要承诺生成 60 秒广告。
• 免费套餐每天只能生成一次。在免费账户的用户计划批量生成前，要先告知这一点。
• result_meta 包含 seed。如果用户喜欢某次渲染并想要相似版本，请保留该值。

错误

工具失败时，会以工具结果的形式返回 isError: true 和纯文本消息，而不是 HTTP 状态码。"Not authenticated. Reconnect your OpenClip token." 表示需要重新连接或重新创建令牌。验证错误（例如未知创作者或格式错误的简报）会以消息文本的形式返回；修正参数后重试。

提示词转化为操作示例

• “为我的应用制作一条 UGC 广告” - list_ugc_creators，挑选合适的创作者， generate_ugc(brief={...})，轮询 get_ugc_job_status，返回 video_url。
• “给我三个测试角度” - 每个角度渲染一次，每次只更改一个变量，分别轮询。 免费账户请先检查每日限额。
• “用上次那个女孩” - 使用 list_ugc_jobs 查找之前的任务，读取其创作者信息， 然后复用该创作者。
• “我可以使用哪些创作者？” - 使用 list_ugc_creators，按细分领域分组展示。

相关内容

将真实的长篇视频素材剪辑成短视频，请参阅 openclip-clipping。免费裁剪、剪切和压缩生成的视频片段，请参阅 openclip-video-editing。