GEN_VIDEO API 接口文档

接口信息

POST /openapi/capcut-mate/v1/gen_video

功能描述

提交视频生成任务。该接口采用异步处理模式，立即返回任务提交状态，视频生成在后台进行。支持任务排队，确保系统稳定性。

更多文档

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

请求参数

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

参数说明

参数详解

草稿URL参数

• draft_url: 草稿的完整URL地址
  • 格式：https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id={草稿ID}
  • 示例："https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
  • 获取方式：通过创建草稿或保存草稿接口获取

响应格式

成功响应 (200)

{
   
  "message": "视频生成任务已提交，请使用draft_url查询进度"
}

响应字段说明

错误响应 (4xx/5xx)

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

使用示例

cURL 示例

1. 基本视频生成

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

错误码说明

注意事项

1. 处理时间: 视频生成是耗时操作，可能需要几分钟到几十分钟
2. 文件大小: 草稿复杂度和素材数量会影响处理时间
3. 网络稳定: 确保素材URL可以稳定访问
4. 超时设置: 建议设置较长的超时时间或使用轮询机制
5. 并发限制: 避免同时生成大量视频
6. 存储空间: 生成的视频文件可能很大，注意存储空间
7. URL有效期: 生成的video_url可能有时效性限制
8. 系统要求: 视频生成功能仅在Windows系统上可用

工作流程

1. 验证draft_url参数
2. 解析草稿配置文件
3. 下载所有必需的素材文件
4. 按时间轴排列和处理素材
5. 应用视觉效果和转场
6. 混合音频轨道
7. 渲染最终视频
8. 编码并上传视频文件
9. 返回视频URL

相关接口

• 创建草稿
• 保存草稿
• 添加视频
• 添加音频
• 添加图片
• 获取草稿
• 查询视频生成状态