SAVE_DRAFT API 接口文档

接口信息

POST /openapi/capcut-mate/v1/save_draft

功能描述

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

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

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

参数说明

参数详解

draft_url

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

响应格式

成功响应 (200)

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

响应字段说明

错误响应 (4xx/5xx)

{
   
  "detail": "错误信息描述"
}

使用示例

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"
  }'

错误码说明

注意事项

1. URL有效性: 确保传入的draft_url是有效且存在的
2. 网络稳定性: 保存操作需要稳定的网络连接
3. 频率控制: 避免过于频繁的保存操作
4. 并发安全: 同一草稿的并发保存可能导致冲突

工作流程

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

相关接口

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