OpenClip 转录

OpenClip: 转录

transcribe 可将视频或音频文件转换为带时间码的转录文本。它完全免费，需要一个 OpenClip 账户，但无需订阅或积分。输出格式包括：JSON（结构化，含时间信息）、SRT 和 VTT。

设置（一次性）

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。

工作流程

1. 上传。 create_upload(filename, content_type) 返回一个 id 和一个 upload_url。将原始字节 PUT 到 upload_url，然后将 id 作为 video 参数传入。 不要调用 complete_upload，那会启动付费的剪辑流水线。免费工具会直接读取上传的文件。list_videos 中已有的视频也可以作为输入。
2. 转录。 transcribe(video, language?, diarize?)。
   • language - 省略则自动检测。如果已知语言，可以设置此项，以防止短音频或嘈杂片段被误识别。
   • diarize - 默认为 true，标记说话人。对于单说话人音频，关闭此选项可使输出更简洁。
3. 轮询。 返回一个 tool_job 哈希 ID。每 5 到 10 秒轮询 get_tool_job_status(tool_job)。queued / processing 表示正在处理，completed 返回永久的 CDN outputs URL（每种格式一个：json、srt、vtt），failed 返回 error。大多数任务在一两分钟内完成。
4. 读取输出。 获取 JSON 输出以进行程序化工作（包含开始和结束时间的片段、说话人标签）。当用户需要字幕文件时，提供 SRT 或 VTT 的 URL。

两种不同的转录工具

请勿混淆：

• transcribe - 免费工具。适用于你上传的任何文件。本技能。
• get_transcript - 读取已通过付费剪辑流水线的视频的转录内容。支持句子或单词级别的 start_ms / end_ms 窗口。适用于已经拥有剪辑 job_id 的情况，不适用于新上传的文件。

规则

• 始终进行轮询。转录是异步的，不会同步返回文本。
• 时间单位为毫秒。
• 输出 URL 是永久的 CDN 链接，不会被签名或过期。
• 免费使用有每日速率限制和单文件大小上限。错误文本会解释如何解除限制。

示例提示与操作

• “转录这段采访” - create_upload，PUT 字节，transcribe(video)，轮询，返回转录结果。
• “我需要这个视频的 SRT 字幕” - 同上，然后返回 srt 输出 URL。
• “谁在这个会议录音里说了什么？” - transcribe(video, diarize=true)，轮询，读取 JSON 输出并按说话人分组片段。
• “从这次演讲中提取最佳引语” - 转录，轮询，读取 JSON，然后选择带有时间码的引语。
• “这是荷兰语，转录它” - transcribe(video, language="nl")，轮询。

相关

如需随后根据这些时间码裁剪视频，请参见 openclip-video-editing（使用 operation="trim" 的 edit_video）。如需自动找到值得裁剪的时刻，请参见 openclip-clipping。