openclip-captions

OpenClip：为片段添加字幕

render_clip 会将动态字幕嵌入 OpenClip 剪辑流水线生成的热门片段中。这是付费流水线的一部分，需要有效订阅和额度。

这里的字幕会直接渲染到视频中，而不是作为单独的字幕文件。如果用户需要 SRT 或 VTT 文件，请使用免费的 transcribe 工具，参见 openclip-transcription。

设置（仅需一次）

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

• Claude Code： claude mcp add --transport http openclip https://openclip.app/mcp，然后输入 /mcp 进行授权。
• Claude Desktop / 网页版： 打开 Settings、Connectors，选择 "Add custom connector"，粘贴 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，确认 credits_remaining > 0。

操作流程

1. 获取片段。 你需要从 list_clips(job_id) 获取 moment_id。如果用户还没有通过流水线处理视频，请先从 submit_video 开始，参见 openclip-clipping 技能。
2. 选择预设。 调用 list_caption_presets 获取当前可用的键。已知键包括： default、dan、dan-reveal、pop、mozi、kendrick、sara、lucy、tayo、beast。 务必通过调用确认，键可能会变更。该调用还会返回完整的字幕样式属性架构和字幕位置选项，使用命名预设以外的自定义样式时需要这些信息。
3. 渲染。 render_clip(moment_id, caption_preset)。
4. 轮询。 渲染是异步的。轮询 list_clips(job_id)，查看该片段的 rendered_clip 字段。字段出现时，其中会包含已完成的字幕视频 {url, size_bytes}。get_render_status 会直接报告渲染状态。

选择预设

预设是视觉样式，不只是字体。用户提到创作者或风格时，请进行匹配：

• 字体大而醒目、逐词弹出并带粗描边——beast。
• 简洁易读，适合作为品牌账号的安全默认选择——default。
• 活泼俏皮——pop。
• 逐步显示文字的揭示式效果——dan-reveal。

用户没有特别要求时，使用 default，并展示其他键供他们更换。 如果用户想要的效果没有任何预设涵盖，请从 list_caption_presets 获取字幕样式属性架构，并创建自定义样式，而不是勉强使用近似的预设。

规则

• 渲染前务必通过 list_caption_presets 确认预设键。未知的 caption_preset 会在工具结果中返回验证消息。
• 务必轮询。render_clip 会立即返回，此时视频尚未就绪。
• 可以使用不同预设重新渲染片段。rendered_clip 会显示最近一次成功渲染的结果。
• clip 是尚未渲染的剪辑，clip_watermarked 是带水印的版本，rendered_clip 是带字幕的输出。请将正确的版本交给用户。
• 时间单位为毫秒。

错误

工具调用失败时，会以工具结果的形式返回 isError: true 和纯文本消息，而不是 HTTP 状态码。

• "Viral moment not found."——moment_id 错误或属于其他账户。请重新调用 list_clips，并使用该响应中的 ID。
• "Not authenticated. Reconnect your OpenClip token."——重新连接或重新创建令牌。
• 未知的预设键会返回验证消息文本。请调用 list_caption_presets，并使用有效键重试。

从示例提示词到操作

• “为那个片段添加字幕” - list_caption_presets、render_clip(moment_id, caption_preset="default")，然后轮询。
• “做成 MrBeast 的风格” - render_clip(moment_id, caption_preset="beast")，然后轮询。
• “有哪些字幕样式？” - list_caption_presets，显示各个键。
• “为排名前三的片段都添加字幕” - list_clips，按 virality_score 取排名前三的片段，分别调用 render_clip， 轮询，直到每个片段都出现 rendered_clip。
• “我想把字幕放在顶部，并使用我的品牌字体” - 使用 list_caption_presets 查看样式架构 和位置选项，然后使用自定义样式进行渲染。

相关内容

要生成待添加字幕的片段，请使用 openclip-clipping。独立的 SRT 和 VTT 字幕文件请使用 openclip-transcription。有关将字幕预设固定为可重复使用的处理 Agent 的内容，请参阅 openclip-clipping。