用途 该技能用于让代理直接编辑视频文件,适用于本地视频的上传、变换与结果获取。主要面向需要在自动化流程中对单个视频做基础处理的场景。
主要能力 edit_video 每次调用执行一种操作:
- crop:按比例(1:1、9:16、16:9、4:5)或显式 x、y、width、height 裁切;可用 aspect: "9:16" 将横屏素材改为竖屏,用于 TikTok、Reels、Shorts。
- trim:按 start_ms 和 end_ms 截取片段,时间单位为毫秒。
- rotate:旋转 90/180/270 度,并可 flip 水平或垂直翻转。
- resize:按像素宽高缩放。
- compress:按 target_mb 目标体积或 crf(18 至 32,越低画质越好、文件越大)压缩。
- mute:移除音轨。
使用方式 首次需连接远程 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 中添加自定义连接器并粘贴 URL 后登录。Cursor 在 .cursor/mcp.json 中配置 mcpServers 的 openclip url。仅支持请求头的客户端可在 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 到该 URL,再把返回的 id 作为 video 参数。注意不要调用 complete_upload,因为那会启动付费剪辑流水线;免费工具直接读取已上传文件,list_videos 中已有的视频也可作为输入。
edit_video 返回带 tool_job 的任务标识和 queued 状态,需每 5 至 10 秒轮询 get_tool_job_status(tool_job)。queued/processing 表示继续等待,completed 返回永久 CDN 输出链接与 result_meta,failed 返回错误。不要假设调用同步完成。
组合操作需串联调用:例如先 trim 截取,再用其输出执行 crop 裁切为 1:1;或先截取前 30 秒,再轮询。时间一律使用毫秒。
适用场景 适合单个视频的基础变换,如为短视频平台裁切竖屏、按要求截取片段、压缩到指定体积、去音轨、调整尺寸与方向等。
限制 每次调用只执行一种操作;免费使用有每日频率限制与单文件大小上限,错误信息会说明如何解除限制;格式转换(mp4、gif、mp3)属于 convert_media 技能,长视频拆条为付费流水线,均不在本技能范围内。