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 令牌，然后连接到https://openclip.app/mcp/key，使用Authorization: Bearer <token>。
检查：调用 get_account。
循环流程
- 首先发现花名册。
list_ugc_creators返回该团队有效的creator和start_frame值：一个经过筛选的花名册加上团队自己保存的创作者，按领域分组。永远不要猜测创作者名称，请从这个调用中选择一个。 - 生成。 调用
generate_ugc(...)，参数可以是：brief_name：服务端预设，快速路径；或brief：结构化创意字段（character等）的内联对象。
- 轮询。 返回一个
ugc_job哈希 ID。每10到15秒轮询get_ugc_job_status(ugc_job)。queued/rendering表示正在处理。completed返回video_url以及result_meta（时长、尺寸、帧率、种子）。failed返回error。 - 回顾过往作品。
list_ugc_jobs列出团队以前的 UGC 片段，如果丢失了ugc_jobID，可以通过它找到要轮询的 ID。
简报是结构化的，不是提示词
这是代理最容易出错的地方。brief 不是一段散文式的提示词。它是一个由离散创意字段（character 以及 API 接受的其他字段）组成的对象。将一个段落塞进一个字段会浪费结构，产生混乱的结果。
每个字段应写成具体、可见、可拍摄的细节：
- 写明画面中有什么，而不是它应该给人什么感觉。“瓶子举到胸口高度，身后是厨房台面”优于“充满活力和抱负的氛围”。
- 每个字段一个想法。不要把三件事塞进
character字段里。 - 约束条件比形容词能产出更好的结果。一个具体的场景、一个具体的道具和一个具体的动作，优于“高质量、专业、吸引人”。
测试广告角度
当用户想要多个变体而非一个片段时，每次渲染只改变一个变量，这样比较才有意义：
- 同一创作者，不同的钩子。
- 同一钩子，不同的创作者——当你测试谁能更好地传达信息时。
- 其他一切相同，不同的
start_frame——当你测试缩略图时机时。
免费账户每天只能获得一次生成，因此在免费账户上，把这次机会用在最有差异化的那个角度上，而不是近似的重复。在承诺批量生成之前，先检查 get_account。
规则
- 每次会话中第一次生成之前，必须先调用
list_ugc_creators。花名册是团队专属的，并且会变化。 - 始终轮询。渲染需要数分钟，
generate_ugc会立即返回。 - 片段设计得很短，大约7到12秒。不要承诺制作60秒的广告。
- 免费层级每天只能生成一次。在用户计划在免费账户上批量生成之前，请告知这一点。
result_meta包含seed。当用户喜欢某个渲染并想要一个接近的变体时，请保留它。
错误
工具失败以 isError: true 和纯文本消息的形式返回，而不是 HTTP 状态码。"未认证。请重新连接你的 OpenClip 令牌。" 意味着重新连接或重新生成令牌。验证消息（未知创作者、格式错误的简报）会以消息文本形式返回，修正参数后重试。
示例提示到动作
- “为我的应用制作一个 UGC 广告” -
list_ugc_creators，选择一个合适的创作者，generate_ugc(brief={...})，轮询get_ugc_job_status，返回video_url。 - “给我三个要测试的角度” - 每个角度一次渲染，每次更改一个变量，分别轮询。先在免费账户上检查每日限制。
- “用上次那个女孩” -
list_ugc_jobs找到之前的任务，读取其创作者，重复使用。 - “我可以使用哪些创作者？” -
list_ugc_creators，按领域分组展示。
相关
将真实的长视频素材剪辑成短视频是 openclip-clipping。对生成的片段进行免费剪辑、裁剪和压缩是 openclip-video-editing。