CREATE_DRAFT API 接口文档

🌐 语言切换

中文版 | English

接口信息

POST /openapi/capcut-mate/v1/create_draft

功能描述

创建剪映草稿。该接口用于创建一个新的剪映草稿项目，可以自定义视频的宽度和高度。创建成功后会返回草稿URL和帮助文档URL，为后续的视频编辑操作提供基础。

请求参数

{
  "width": 1920,
  "height": 1080
}

参数说明

参数名	类型	必填	默认值	说明
width	integer	❌	1920	视频宽度(像素)，必须大于等于1
height	integer	❌	1080	视频高度(像素)，必须大于等于1

参数详解

尺寸参数

• width: 草稿视频的宽度

  • 最小值：1像素
  • 建议常用值：1920、1280、720
  • 支持自定义尺寸

• height: 草稿视频的高度

  • 最小值：1像素
  • 建议常用值：1080、720、480
  • 支持自定义尺寸

常用分辨率

分辨率名称	宽度	高度	适用场景
1080P	1920	1080	高清视频制作
720P	1280	720	标清视频制作
4K	3840	2160	超高清视频制作
竖屏短视频	1080	1920	手机短视频
正方形	1080	1080	社交媒体内容

响应格式

成功响应 (200)

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

响应字段说明

字段名	类型	说明
draft_url	string	新创建的草稿URL，用于后续的编辑操作
tip_url	string	草稿使用帮助文档URL

错误响应

{
  "code": 2002,
  "message": "草稿创建失败"
}

💻 使用示例

cURL 示例

1. 创建默认分辨率草稿

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{}'

2. 创建自定义分辨率草稿

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1280,
    "height": 720
  }'

3. 创建竖屏短视频草稿

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1080,
    "height": 1920
  }'

错误码说明

错误码	错误信息	说明	解决方案
1001	参数校验失败	width/height 不是整数或小于 1	提供大于等于 1 的整数值
2002	草稿创建失败	基于模板创建草稿失败	稍后重试或联系技术支持

注意事项

1. 参数验证: width和height必须为正整数
2. 分辨率建议: 建议使用常见的视频分辨率以确保兼容性
3. 性能考虑: 超高分辨率可能影响后续处理性能
4. 存储占用: 高分辨率草稿会占用更多存储空间
5. URL有效期: 返回的draft_url具有一定的有效期

工作流程

1. 接收并验证请求参数
2. 创建草稿基础结构
3. 设置画布尺寸
4. 生成草稿URL
5. 返回草稿信息和帮助文档链接

相关接口

• 添加视频
• 添加音频
• 添加图片
• 保存草稿
• 生成视频

---

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

语言切换

中文版 | English