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 / 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。
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 hashid，状态为 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。