EASY_CREATE_MATERIAL API 接口文档

接口信息

功能描述

在现有草稿中添加多种类型的素材内容，包括音频、视频、图片和文字。该接口可以一次性向草稿添加多种媒体素材，自动处理素材的时长、尺寸等属性，并智能管理不同类型的媒体轨道。是视频创作的核心接口之一。

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

请求参数

{
  "draft_url": "https://agent.aigc-ai.com/openapi/capcut-tools/v1/get_draft?draft_id=2025092811473036584258",
  "audio_url": "https://assets.jcaigc.cn/audio.mp3",
  "text": "Hello World",
  "img_url": "https://s.coze.cn/t/JTa5Ne6_liY/",
  "video_url": "https://assets.jcaigc.cn/video.mp4",
  "text_color": "#ff0000",
  "font_size": 20,
  "text_transform_y": 100
}

参数说明

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整 URL
audio_url string ✅ - 音频文件 URL，不能为空或 null
text string ❌ null 要添加的文字内容
img_url string ❌ null 图片文件 URL
video_url string ❌ null 视频文件 URL
text_color string ❌ "#ffffff" 文字颜色（十六进制格式）
font_size integer ❌ 15 字体大小
text_transform_y integer ❌ 0 文字 Y 轴位置偏移

参数详解

必填参数

可选参数

素材处理规则

响应格式

成功响应 (200)

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

响应字段说明

字段名 类型 说明
draft_url string 更新后的草稿 URL

错误响应 (4xx/5xx)

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

使用示例

cURL 示例

1. 添加所有类型素材

curl -X POST https://agent.aigc-ai.com/openapi/capcut-tools/v1/easy_create_material \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL",
    "audio_url": "https://assets.jcaigc.cn/audio.mp3",
    "text": "Hello World",
    "img_url": "https://s.coze.cn/t/JTa5Ne6_liY/",
    "video_url": "https://assets.jcaigc.cn/video.mp4",
    "text_color": "#ff0000",
    "font_size": 20,
    "text_transform_y": 100
  }'

2. 仅添加音频和文字

curl -X POST https://agent.aigc-ai.com/openapi/capcut-tools/v1/easy_create_material \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL",
    "audio_url": "https://assets.jcaigc.cn/background_music.mp3",
    "text": "欢迎观看",
    "text_color": "#0066ff",
    "font_size": 18
  }'

3. 最简请求（仅音频）

curl -X POST https://agent.aigc-ai.com/openapi/capcut-tools/v1/easy_create_material \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL",
    "audio_url": "https://assets.jcaigc.cn/audio.wav"
  }'

错误码说明

错误码 错误信息 说明 解决方案
400 draft_url 是必填项 缺少草稿 URL 参数 提供有效的 draft_url
400 audio_url 是必填项 缺少音频 URL 参数 提供有效的 audio_url
400 无效的草稿信息，请检查草稿参数是否正确 草稿参数校验失败 检查草稿参数是否符合要求
404 草稿不存在 指定的草稿 URL 无效 检查草稿 URL 是否正确
500 素材创建失败 内部处理错误 联系技术支持

注意事项

工作流程

  1. 接收并验证请求参数
  2. 验证 draft_url 的有效性
  3. 检查 audio_url 是否提供且有效
  4. 依次处理各类素材（音频、视频、图片、文字）
  5. 自动设置素材时长、尺寸等属性
  6. 将素材添加到对应轨道
  7. 更新草稿信息
  8. 返回更新后的 draft_url

相关接口