EASY_CREATE_MATERIAL API 接口文檔

接口信息

POST /openapi/capcut-mate/v1/easy_create_material

功能描述

在現有草稿中添加多種類型的素材內容，包括音頻、視頻、圖片和文字。該接口可以一次性向草稿添加多種媒體素材，自動處理素材的時長、尺寸等屬性，並智能管理不同類型的媒體軌道。是視頻創作的核心接口之一。

更多文檔

📖 更多詳細文檔和教程請訪問：https://docs.jcaigc.cn

請求參數

{
  "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258",
  "audio_url": "https://xxx/audio.mp3",
  "text": "Hello World",
  "img_url": "https://s.coze.cn/t/JTa5Ne6_liY/",
  "video_url": "https://xxx/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 ❌ 文字Y軸位置偏移

參數詳解

必填參數

  • draft_url: 目標草稿的完整URL

    • 格式：必須是有效的剪映草稿URL
    • 示例："https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"

  • audio_url: 音頻文件URL

    • 必填參數，不能為空或"null"
    • 支持格式：MP3, WAV, AAC等常見音頻格式
    • 説明：音頻是必填參數，其他素材類型都是可選的
可選參數

  • text: 要添加的文字內容

    • 類型：UTF-8文本
    • 默認值：null（不添加文字）
    • 説明：如果提供，將添加文字素材到草稿中

  • img_url: 圖片文件URL

    • 類型：有效的圖片URL
    • 默認值：null（不添加圖片）
    • 支持格式：JPEG, PNG, GIF等常見圖片格式
    • 説明：如果提供，將添加圖片素材到草稿中

  • video_url: 視頻文件URL

    • 類型：有效的視頻URL
    • 默認值：null（不添加視頻）
    • 支持格式：MP4, AVI, MOV等常見視頻格式
    • 説明：如果提供，將添加視頻素材到草稿中

  • text_color: 文字顏色

    • 類型：十六進制顏色代碼
    • 默認值："#ffffff"（白色）
    • 説明：設置文字顏色，使用標準十六進制格式（如 #ffffff、#000000）

  • font_size: 字體大小

    • 類型：整數
    • 默認值：15
    • 説明：設置文字字體大小，建議範圍10-50

  • text_transform_y: 文字Y軸位置偏移

    • 類型：整數
    • 默認值：0
    • 説明：調整文字在畫面中的垂直位置，單位為像素
素材處理規則

  • 音頻處理：

    • 自動解析音頻時長
    • 添加到音頻軌道
    • 支持多種音頻格式

  • 視頻處理：

    • 固定顯示時長5秒
    • 保持原始分辨率比例
    • 添加到視頻軌道

  • 圖片處理：

    • 默認顯示時長3秒
    • 自動獲取圖片尺寸
    • 添加到圖片軌道

  • 文字處理：

    • 默認顯示時長5秒
    • 支持顏色和字體大小設置
    • 可調整垂直位置

響應格式

成功響應 (200)

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

響應字段説明

字段名 類型 説明
draft_url string 更新後的草稿URL

錯誤響應 (4xx/5xx)

{
  "detail": "錯誤信息描述"
}

使用示例

cURL 示例

1. 添加所有類型素材
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/easy_create_material \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL",
    "audio_url": "https://xxx/audio.mp3",
    "text": "Hello World",
    "img_url": "https://s.coze.cn/t/JTa5Ne6_liY/",
    "video_url": "https://xxx/video.mp4",
    "text_color": "#ff0000",
    "font_size": 20,
    "text_transform_y": 100
  }'
2. 僅添加音頻和文字
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/easy_create_material \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL",
    "audio_url": "https://xxx/background_music.mp3",
    "text": "歡迎觀看",
    "text_color": "#0066ff",
    "font_size": 18
  }'
3. 最簡請求（僅音頻）
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/easy_create_material \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL",
    "audio_url": "https://xxx/audio.wav"
  }'

錯誤碼説明

錯誤碼 錯誤信息 説明 解決方案
400 draft_url是必填項 缺少草稿URL參數 提供有效的draft_url
400 audio_url是必填項 缺少音頻URL參數 提供有效的audio_url
400 無效的草稿信息，請檢查草稿參數是否正確 草稿參數校驗失敗 檢查草稿參數是否符合要求
404 草稿不存在 指定的草稿URL無效 檢查草稿URL是否正確
500 素材創建失敗 內部處理錯誤 聯繫技術支持

注意事項

  1. 音頻必填: audio_url是必填參數，不能為空或null
  2. 素材URL: 素材URL必須可公開訪問，建議使用HTTPS協議
  3. 文字顏色: text_color使用標準十六進制格式（如 #ffffff、#000000）
  4. 字體大小: font_size建議範圍10-50
  5. 位置偏移: text_transform_y用於調整文字在畫面中的垂直位置
  6. 時長設置: 不同素材類型有不同的默認顯示時長
    • 音頻：自動獲取原始時長
    • 視頻：固定5秒
    • 圖片：默認3秒
    • 文字：默認5秒
  7. 軌道管理: 系統自動創建不同類型素材的軌道
  8. 性能考慮: 避免同時添加大量素材

工作流程

  1. 驗證必填參數（draft_url, audio_url）
  2. 從緩存中獲取草稿
  3. 創建音頻軌道並添加音頻素材
  4. 如果提供，創建視頻軌道並添加視頻素材
  5. 如果提供，創建圖片軌道並添加圖片素材
  6. 如果提供，創建文字軌道並添加文字素材
  7. 保存草稿
  8. 返回更新後的草稿URL

相關接口

  • 創建草稿
  • 添加視頻
  • 添加音頻
  • 添加圖片
  • 保存草稿
  • 生成視頻

📚 項目資源
GitHub: 搜索capcut-mate即可找到