SuperAPI AI 工具集

openclip-repurpose

设计与创作

查看项目

更新于 10-20 17:12

技能介绍

OpenClip: repurpose 是一个把长视频批量转为短视频的端到端工作流技能。它的目标是把一条长视频变成一组可直接发布的竖屏片段,每个片段带有字幕和社交文案,并串联 OpenClip 切片流水线、字幕功能与免费媒体工具。

用途与定位 该技能面向需要从播客、网络研讨会等长内容中批量产出平台短片的场景。开始前需与用户确认两件事:要多少个片段、投放到哪些平台;这两个答案决定后续所有操作,不应替用户擅自决定。

主要能力

  • 提交源视频:submit_video(url) 返回 job_id 与 queued 状态;本地文件则先 create_upload,PUT 上传字节,再 complete_upload。
  • 异步轮询:用 get_video_status(job_id) 直至 completed;若立即失败通常表示没有有效订阅,pending_credits 表示积分不足,应明确告知并停止轮询终态。
  • 高光筛选:list_clips(job_id) 按 virality_score(0–10)排序取所需数量,渲染前先向用户展示标题、钩子、时长与评分,便于否决,因为渲染消耗积分。
  • 字幕渲染:list_caption_presets 查看预设,再对每个已确认片段调用 render_clip(moment_id, caption_preset),并轮询 list_clips 直到每个片段都有 rendered_clip。
  • 画幅重构:流水线输出已面向短视频;如需特定平台比例,可对成片运行免费的 edit_video(video, operation="crop", aspect="9:16" | "1:1" | "4:5")。
  • 批量交付:为每个片段提供 rendered_clip URL、标题、钩子、social_copy、duration_ms、virality_score 与建议平台字段。

平台画幅建议 TikTok、Reels、Shorts 为 9:16 竖屏,是流水线默认目标;Instagram feed 可用 4:5 或 1:1,通过 edit_video 裁切;X 与 LinkedIn 可用 16:9 或 1:1,字幕比画幅更重要,因为多数自动静音播放。每个片段自带 platforms 字段,可作为起始建议而非硬性规则,需与用户实际发布平台协调。

效率与成本控制 批量轮询:提交一次后循环查询状态,不要重复提交。只为已确认的片段渲染,避免多渲染。对于固定字幕、构图、水印的重复工作流,可用 create_agent 保存处理代理并传给 submit_video,使后续批次保持一致;describe_agent_settings 可列出全部字段。大批量前用 get_usage 查看积分余额(积分即处理分钟数)。

使用方式与接入 OpenClip 是位于 https://openclip.app/mcp 的远程 MCP 服务器,出现 OAuth 提示时用 OpenClip 账号登录,无需复制 API key。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 token,连接 https://openclip.app/mcp/key,使用 Authorization: Bearer <token>。自检:调用 get_account 确认 credits_remaining > 0。

规则与限制 始终轮询,每步都是异步的;按 virality_score 排序,越高越好,可用 viral_score_details(钩子强度、可分享性、可重看性、惊喜度、情绪影响)解释排名;时间单位为毫秒;片段 URL 是永久 CDN 链接,不签名不过期;不支持项目与文件夹,不要向用户承诺目录结构;除非被要求,不要将 social_copy 改写为网红口吻,过度改写通常会变差。

示例对应 “把这段播客做成 10 条 TikTok”:提交、轮询、list_clips、展示前 10 候选、获批后逐条带字幕渲染、轮询、交付批次。“给我一周的内容”:同样流程,按 5–7 条规模,并按片段 category 分组。“只要最好的那条,字幕像 MrBeast”:取最高 virality_score,render_clip(moment_id, caption_preset="beast")。“和上次一样”:在 submit_video 复用已保存的 agent id。

付费与免费 切片流水线为付费功能,需要有效订阅与积分;重构画幅和修剪工具免费。

相关技能 流水线机制与状态处理详见 openclip-clipping;字幕预设与自定义字幕样式见 openclip-captions;免费裁切、修剪与压缩见 openclip-video-editing。