主题
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": ""
}