openclip-convert

OpenClip：媒体转换

convert_media 用于改变文件的容器格式或编码，包括视频转 GIF 和视频转纯音频。它完全免费，需要 OpenClip 账户，但无需订阅或积分。

设置（一次性）

OpenClip 是一个远程 MCP 服务器，地址为 https://openclip.app/mcp。当出现 OAuth 提示时，使用你的 OpenClip 账户登录；无需复制 API 密钥。

• Claude Code： claude mcp add --transport http openclip https://openclip.app/mcp，然后运行 /mcp 进行授权。
• Claude Desktop / 网页版： 设置 → 连接器 → “添加自定义连接器”，粘贴 URL 并登录。
• Cursor （.cursor/mcp.json）：{ "mcpServers": { "openclip": { "url": "https://openclip.app/mcp" } } }
• 仅支持标头的客户端： 在 openclip.app/settings/connect 生成一个 MCP 令牌，然后使用 Authorization: Bearer <令牌> 连接到 https://openclip.app/mcp/key。

快速检查：调用 get_account。

上传文件

1. 调用 create_upload(filename, content_type)，它返回一个 id 和一个 upload_url。
2. 使用 PUT 方法将原始字节上传到 upload_url。
3. 将返回的 id 作为 file 参数传入。

不要调用 complete_upload。 该函数会启动付费的剪辑流水线。免费工具直接读取已上传的文件。如果文件已经在 list_videos 中，也可以直接作为输入使用。

输出目标

convert_media(file, to, ...params)。

• 视频容器 - mp4、webm、mov、mkv。当用户只要求“能在任何地方播放”时，默认使用 mp4。
• gif - 可选参数 fps（默认 12）和 width（默认 480）。提高 fps 可让动画更流畅，提高 width 可让 GIF 更清晰，但两者都会使文件大幅增大。如果源视频很长，请先裁剪，GIF 文件大小增长很快。
• 音频 - mp3、aac、wav、flac。用于从视频中提取音频。mp3 用于分享，wav 或 flac 用于需要无损音频的其他工具。

若要控制文件大小而非转换格式，请使用 edit_video 并设置 operation="compress"（target_mb 或 crf），请参考 openclip-video-editing 技能。

轮询

convert_media 返回一个 tool_job 哈希 ID，其 status 为 "queued"。每隔 5 到 10 秒轮询 get_tool_job_status(tool_job)：

• queued / processing - 仍在处理中，继续轮询。
• completed - 返回永久的 CDN outputs URL 和 result_meta。
• failed - 返回 error。

切勿假设调用是同步完成的。

规则

• 始终轮询，转换是异步的。
• 输出 URL 是永久的 CDN 链接，不会过期或需要签名。
• 免费使用有每日速率限制和单个文件大小上限。错误消息会说明如何解除限制。
• 将长视频转换为 GIF 会生成巨大的文件。请先裁剪到有趣的几秒钟，再执行转换。

示例提示词 → 操作

• “把这个转成 mp4” - create_upload，PUT 字节，convert_media(file, to="mp4")，轮询。
• “把这个做成 GIF” - 先用 edit_video 裁剪到关键片段，然后 convert_media(file, to="gif", fps=15, width=640)，轮询。
• “只要音频” - convert_media(file, to="mp3")，轮询。
• “我需要无损音频用于编辑” - convert_media(file, to="wav")，轮询。

相关技能

裁剪、旋转和按目标大小压缩的功能位于 openclip-video-editing 中。转录刚提取的音频请使用 openclip-transcription。