Skip to content

save_draft ​

POST /save_draft

接口说明 ​

保存当前草稿,并按需要生成可下载的草稿包或写入指定草稿目录。适合服务端完成编辑后,把草稿交给本地剪映继续精修。保存是异步任务,可以再用 query_draft_status 查询进度。

请求参数 ​

参数必填默认值说明
draft_id是—草稿 ID,创建草稿后获得
draft_folder是—草稿输出目录;本地部署时可指定剪映草稿根目录
project_name是—项目名称
auto_deploy否True是否自动部署草稿文件
auto_reload否False是否请求桌面端自动重载

调用示例 ​

bash
curl -X POST https://your-domain.example/api/save_draft \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "project_name": "我的第一条草稿",
    "auto_deploy": true,
    "auto_reload": false
  }'

返回格式 ​

json
{
  "success": true,
  "output": {
    "success": true,
    "draft_url": "https://your-domain.example/api/draft/downloader?draft_id=dfd_cat_demo_001"
  },
  "error": ""
}

个人自建服务