SuperAPI AI 工具集

openclip-transcription

办公与效率

查看项目

更新于 10-20 16:12

技能介绍

用途 该技能用于把视频或音频文件转录为带时间码的文本,输出格式包括 JSON(含分段起止时间的结构化数据)、SRT 和 VTT 字幕文件。据资料说明,该功能免费,只需 OpenClip 账号,无需订阅和积分。

接入方式(一次性设置) 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 做连通性检查。

主要能力与使用流程

  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 输出 URL(json、srt、vtt 各一个),failed 返回错误。多数任务在一两分钟内完成。
  4. 读取输出:程序化处理时读取 JSON(含分段起止时间和说话人标签);需要字幕文件时把 SRT 或 VTT 的 URL 交给用户。

两类转录工具的区别

  • transcribe:免费工具,适用于任意上传文件,即本技能。
  • get_transcript:读取已经过付费剪辑流程的视频转录,支持按句子或词级的 start_ms / end_ms 窗口;仅用于已有剪辑 job_id 的场景,不用于新上传文件。

规则与限制 转录是异步的,必须轮询,不会同步返回文本;时间单位为毫秒;输出 URL 是永久 CDN 链接,非签名链接、不过期。免费使用有每日频率限制和单文件大小上限,具体错误文本会说明如何解除限制。具体限额数值资料未提供。

适用场景示例 转录访谈;为视频生成 SRT 字幕;识别会议录音中谁说了什么(开启 diarize 后按说话人分组);从演讲中提取带时间码的引语;指定语言(如荷兰语 language="nl")转录。若需按时间码裁剪视频,可参阅 openclip-video-editing 的 edit_video(operation="trim");若需自动寻找值得剪辑的片段,可参阅 openclip-clipping。