CREATE_DRAFT API 接口文档

接口信息

功能描述

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

更多文档: 📖 速创 AIGC-工具平台官方文档

请求参数

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

参数说明

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

参数详解

尺寸参数

常用分辨率

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

响应格式

成功响应 (200)

{
  "draft_url": "https://cm.jcaigc.cn/openapi/v1/get_draft?draft_id=2025092811473036584258",
  "tip_url": "https://help.assets.jcaigc.cn/draft-usage"
}

响应字段说明

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

错误响应 (4xx/5xx)

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

使用示例

cURL 示例

1. 创建默认分辨率草稿

curl -X POST https://agent.aigc-ai.com/openapi/capcut-tools/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{}'

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

curl -X POST https://agent.aigc-ai.com/openapi/capcut-tools/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1280,
    "height": 720
  }'

3. 创建竖屏短视频草稿

curl -X POST https://agent.aigc-ai.com/openapi/capcut-tools/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1080,
    "height": 1920
  }'

错误码说明

错误码 错误信息 说明 解决方案
400 width 必须大于等于 1 宽度参数无效 提供大于等于 1 的宽度值
400 height 必须大于等于 1 高度参数无效 提供大于等于 1 的高度值
400 参数类型错误 参数类型不正确 确保 width 和 height 为数字类型
500 草稿创建失败 内部服务错误 联系技术支持
503 服务不可用 系统维护中 稍后重试

注意事项

工作流程

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

相关接口