openclip-transcription

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： 打开 Settings，选择 Connectors 和 "Add custom connector"，粘贴 URL 并登录。
• Cursor（.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• 仅支持 Header 的客户端： 在 openclip.app/settings/connect 创建 MCP 令牌，并使用 Authorization: Bearer <token> 连接到 https://openclip.app/mcp/key。

快速检查：调用 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 hashid。每隔 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 链接，不是签名链接，也不会过期。
• 免费使用每天有频率限制，每个文件也有大小上限。错误文本会说明如何解除限制。

从示例提示词到操作

• "Transcribe this interview" - create_upload，PUT 字节，transcribe(video)，轮询，然后返回转录稿。
• "I need an SRT for this video" - 同上，然后返回 srt 输出 URL。
• "Who said what in this meeting recording?" - transcribe(video, diarize=true)，轮询，读取 JSON 输出并按说话人分组片段。
• "Pull the best quotes out of this talk" - 转录、轮询、读取 JSON，然后选出带时间码的引语。
• "It is in Dutch, transcribe it" - transcribe(video, language="nl")，轮询。

相关内容

要按这些时间码剪辑视频，请参阅 openclip-video-editing（edit_video，其中 operation="trim"）。要自动找出值得剪辑的片段，请参阅 openclip-clipping。