@cutcli/cutcli

AI 友好的 CapCut / 剪映草稿命令行工具。它适合被 Agent 实时调用，用命令创建草稿、添加素材、查询状态并提交云渲染。

npm install -g @cutcli/cutcli
cutcli draft create --width 1080 --height 1920
cutcli image add <draftId> --src ./素材/bg.png --start 0s --duration 5s --width 1080 --height 1920
cutcli audio add <draftId> --src ./素材/bgm.mp3 --start 0s --duration 5s

云渲染管理

cutcli 支持直接将草稿一键打包、上传并提交至云渲染服务，最终获取可下载的视频 URL。

1. 配置云渲染 API Token： 运行 login 命令将 API Token 保存到本地配置（或设置 CUT_API_TOKEN 环境变量）：

   cutcli login your_api_token_here

2. 提交云渲染任务：

   # 提交渲染并持续轮询直到渲染完成 (--wait)
   cutcli cloud render <draftId> --wait

3. 查询渲染任务结果：

   cutcli cloud result <jobId>

接入 AI Agent

给某个项目安装 AI 使用说明（Agent Skills）：

npm install cutsdk && npx cutsdk init

cutcli agents install 仍保留为兼容命令。