用途
openclip-captions 用于把带动画效果的字幕渲染并烧录到 OpenClip 剪辑流程产出的短视频片段中。字幕直接写入视频画面，不生成 SRT、VTT 等外挂字幕文件；若需要独立的字幕文件，应使用免费的转写工具 openclip-transcription。该功能属于 OpenClip 的付费流程，需要有效的订阅和积分。
主要能力
- 使用命名预设渲染字幕。已知预设键包括 default、dan、dan-reveal、pop、mozi、kendrick、sara、lucy、tayo、beast；预设键可能变化，调用 list_caption_presets 可获得当前键列表。
- 自定义字幕样式。list_caption_presets 同时返回完整的字幕样式属性 schema 和字幕位置选项，可用于预设未覆盖的样式需求。
- 对同一 moment 可用不同预设重新渲染，rendered_clip 反映最近一次成功渲染的结果。
- 区分输出类型：clip 为未渲染的剪切片段，clip_watermarked 为带水印版本，rendered_clip 为带字幕的输出。
- 时间参数以毫秒为单位。
使用方式
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：在 Settings、Connectors 中选择“Add custom connector”，粘贴 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。
典型流程：先通过 list_clips(job_id) 取得 moment_id（若尚未处理视频，先用 submit_video，参见 openclip-clipping）；调用 list_caption_presets 确认预设键；调用 render_clip(moment_id, caption_preset)；渲染是异步的，轮询 list_clips(job_id) 并观察该 moment 的 rendered_clip 字段，出现时包含 {url, size_bytes}，也可用 get_render_status 直接查询渲染状态。
预设选择参考：beast 为大号、醒目、逐词弹出并带粗描边的风格；default 干净易读，适合品牌账号的稳妥默认；pop 活泼弹跳；dan-reveal 为文字逐步出现的揭示风格。用户无偏好时使用 default 并展示其他键供替换；需要预设未覆盖的效果时，从 list_caption_presets 获取样式 schema 构建自定义样式。
适用场景
为短视频片段批量添加风格化动态字幕；按用户描述的创作者风格或氛围映射到相应预设；对多个高传播潜力片段（如按 virality_score 取前 3）逐一渲染字幕；按品牌字体和顶部位置等要求自定义字幕。
限制与错误处理
渲染前应始终用 list_caption_presets 确认预设键，未知预设会返回校验消息。render_clip 立即返回，必须轮询等待成片。工具失败以 isError: true 的纯文本工具结果返回，而非 HTTP 状态。“Viral moment not found.” 表示 moment_id 错误或属于其他账号，需用 list_clips 重新获取；“Not authenticated. Reconnect your OpenClip token.” 表示需重新连接或重新生成 token。