capcut-mate/docs/save_draft.zh.md

SAVE_DRAFT API 接口文档

🌐 语言切换

中文版 | English

接口信息

POST /openapi/capcut-mate/v1/save_draft

功能描述

保存剪映草稿。该接口用于保存当前的草稿状态，确保编辑的内容得到持久化存储。通常在完成一系列编辑操作后调用此接口，以防止编辑内容丢失。

请求参数

{
  "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
}

参数说明

参数名	类型	必填	默认值	说明
draft_url	string	✅	-	要保存的草稿URL

参数详解

draft_url

• 类型: 字符串
• 必填: 是
• 格式: 完整的草稿URL，通常由create_draft接口返回
• 示例: https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258

响应格式

成功响应 (200)

{
  "code": 0,
  "message": "success",
  "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
}

响应字段说明

字段名	类型	说明
draft_url	string	保存后的草稿URL，通常与请求中的URL相同

错误响应

{
  "code": 2001,
  "message": "无效的草稿URL"
}

使用示例

cURL 示例

1. 基本保存草稿

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/save_draft \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
  }'

错误码说明

错误码	错误信息	说明	解决方案
1001	参数校验失败	draft_url 不是字符串	检查参数类型
2001	无效的草稿URL	draft_url 中没有 draft_id，或草稿不在缓存中	传入 create_draft 返回的 draft_url
2042	草稿锁获取超时	草稿正被其它操作占用，等待 30 秒仍未获得锁	稍后重试

注意事项

1. URL有效性: 确保传入的draft_url是有效且存在的
2. 网络稳定性: 保存操作需要稳定的网络连接
3. 频率控制: 避免过于频繁的保存操作
4. 并发安全: 同一草稿的并发操作由草稿锁串行化；30 秒内未获得锁的请求返回错误码 2042

工作流程

1. 验证draft_url参数
2. 检查草稿是否存在
3. 获取当前草稿状态
4. 持久化保存草稿数据
5. 返回保存结果

相关接口

• 创建草稿
• 添加视频
• 添加音频
• 添加图片
• 生成视频

---

📚 项目资源
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate

语言切换

中文版 | English