capcut-mate/docs/gen_video.zh.md

GEN_VIDEO API 接口文档

🌐 语言切换

中文版 | English

接口信息

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

参数说明

参数名	类型	必填	默认值	说明
draft_url	string	✅	-	目标草稿的完整URL

参数详解

草稿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查询进度"
}

响应字段说明

字段名	类型	说明
message	string	响应消息

错误响应 (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"
  }'

错误码说明

错误码	错误信息	说明	解决方案
400	draft_url是必填项	缺少草稿URL参数	提供有效的draft_url
400	draft_url格式无效	URL格式不正确	检查URL格式是否正确
404	草稿不存在	指定的草稿无法找到	确认草稿URL是否正确且存在
400	草稿内容为空	草稿中没有可导出的内容	确保草稿包含视频、音频或图片素材
400	素材无法访问	草稿中的素材文件无法下载	检查素材URL是否有效
500	视频渲染失败	视频处理过程中出错	检查草稿内容或联系技术支持
500	音频处理失败	音频混合过程中出错	检查音频格式或联系技术支持
500	编码失败	最终视频编码失败	联系技术支持
503	服务繁忙	渲染服务器负载过高	稍后重试
504	处理超时	视频生成超时	简化草稿内容或稍后重试
500	视频生成任务提交失败	内部处理错误	联系技术支持

注意事项

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

相关接口

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

---

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

语言切换

中文版 | English