GEN_VIDEO API 接口文档

接口信息

功能描述

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

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

请求参数

{
  "draft_url": "https://agent.aigc-ai.com/openapi/capcut-tools/v1/get_draft?draft_id=2025092811473036584258"
}

参数说明

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

参数详解

草稿 URL 参数

响应格式

成功响应 (200)

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

响应字段说明

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

错误响应 (4xx/5xx)

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

使用示例

cURL 示例

1. 基本视频生成

curl -X POST https://agent.aigc-ai.com/openapi/capcut-tools/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. 验证 draft_url 参数
  2. 解析草稿配置文件
  3. 下载所有必需的素材文件
  4. 按时间轴排列和处理素材
  5. 应用视觉效果和转场
  6. 混合音频轨道
  7. 渲染最终视频
  8. 编码并上传视频文件
  9. 返回视频 URL

相关接口