OpenClip：媒體轉換
convert_media 會變更檔案的容器或編碼格式，包括將影片轉為 GIF 以及將影片轉為純音訊。此功能免費，需要 OpenClip 帳戶，但無需訂閱或點數。
設定（一次性）
OpenClip 是位於 https://openclip.app/mcp 的遠端 MCP 伺服器。當 OAuth 提示出現時，請使用您的 OpenClip 帳戶登入，不需要複製 API 金鑰。
- Claude Code： 執行
claude mcp add --transport http openclip https://openclip.app/mcp，然後使用/mcp進行授權。 - Claude Desktop / Web： 前往「設定」→「連接器」→「新增自訂連接器」，貼上 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。
取得檔案
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則在音訊需要輸入其他工具且要求無失真時使用。
若想控制檔案大小而非變更格式，請使用 edit_video 搭配 operation="compress"（target_mb 或 crf），請參閱 openclip-video-editing 技能。
輪詢
convert_media 會傳回一個 tool_job 雜湊 ID，狀態為 "queued"。每隔 5 到 10 秒輪詢 get_tool_job_status(tool_job)：
queued/processing— 仍在處理中，請繼續輪詢。completed— 傳回永久 CDN 的outputsURL 以及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。