OpenClip 媒体转换技能（openclip-convert）用于更改媒体文件的容器或编码格式，支持把视频转换为 gif，也支持把视频转换为纯音频。该功能免费，需要 OpenClip 账户，但无需订阅，也不消耗积分。
用途 convert_media 负责转换文件的容器或编码格式。需要调整文件大小而不是改变格式时，应使用 edit_video 的 operation="compress"（target_mb 或 crf），参见 openclip-video-editing 技能。
一次性设置 OpenClip 是一个远程 MCP 服务器，位于 https://openclip.app/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。
如何传入文件
- 调用 create_upload(filename, content_type)，返回 id 和 upload_url。
- 把原始字节通过 PUT 上传到 upload_url。
- 把返回的 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 适合需要无损音频的后续工具。
轮询 convert_media 返回带 status: "queued" 的 tool_job 哈希 ID。每 5 到 10 秒轮询一次 get_tool_job_status(tool_job)：
- queued / processing：仍在处理，继续轮询。
- completed：返回永久 CDN 输出 URL 以及 result_meta。
- failed：返回错误。 不要假设调用会同步完成。
规则
- 始终轮询，转换是异步的。
- 输出 URL 是永久 CDN 链接，不是签名链接，也不会过期。
- 免费使用有每日速率限制和单文件大小上限；错误信息会说明如何解除限制。
- 把长视频转换为 gif 会产生超大文件；先裁剪到感兴趣的几秒，再进行转换。
示例提示与操作
- “Convert this to mp4”：create_upload、PUT 字节、convert_media(file, to="mp4")、轮询。
- “Make a gif of this”：先用 edit_video 裁剪到目标片段，再 convert_media(file, to="gif", fps=15, width=640)，轮询。
- “Get me just the audio”：convert_media(file, to="mp3")，轮询。
- “I need lossless audio for editing”：convert_media(file, to="wav")，轮询。
相关技能 裁剪、裁切和按大小压缩见 openclip-video-editing；转写刚提取的音频见 openclip-transcription。