CREATE_DRAFT API 接口文檔

接口信息

POST /openapi/capcut-mate/v1/create_draft

功能描述

創建剪映草稿。該接口用於創建一個新的剪映草稿項目，可以自定義視頻的寬度和高度。創建成功後會返回草稿URL和幫助文檔URL，為後續的視頻編輯操作提供基礎。

更多文檔

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

請求參數

{
  "width": 1920,
  "height": 1080
}

參數説明

參數名	類型	必填	默認值	説明
width	number	❌	1920	視頻寬度(像素)，必須大於等於1
height	number	❌	1080	視頻高度(像素)，必須大於等於1

參數詳解

尺寸參數

• width: 草稿視頻的寬度

  • 最小值：1像素
  • 建議常用值：1920、1280、720
  • 支持自定義尺寸

• height: 草稿視頻的高度

  • 最小值：1像素
  • 建議常用值：1080、720、480
  • 支持自定義尺寸

常用分辨率

分辨率名稱	寬度	高度	適用場景
1080P	1920	1080	高清視頻製作
720P	1280	720	標清視頻製作
4K	3840	2160	超高清視頻製作
豎屏短視頻	1080	1920	手機短視頻
正方形	1080	1080	社交媒體內容

響應格式

成功響應 (200)

{
  "draft_url": "https://cm.jcaigc.cn/openapi/v1/get_draft?draft_id=2025092811473036584258",
  "tip_url": "https://help.assets.jcaigc.cn/draft-usage"
}

響應字段説明

字段名	類型	説明
draft_url	string	新創建的草稿URL，用於後續的編輯操作
tip_url	string	草稿使用幫助文檔URL

錯誤響應 (4xx/5xx)

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

💻 使用示例

cURL 示例

1. 創建默認分辨率草稿

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

2. 創建自定義分辨率草稿

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1280,
    "height": 720
  }'

3. 創建豎屏短視頻草稿

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{
    "width": 1080,
    "height": 1920
  }'

錯誤碼説明

錯誤碼	錯誤信息	説明	解決方案
400	width必須大於等於1	寬度參數無效	提供大於等於1的寬度值
400	height必須大於等於1	高度參數無效	提供大於等於1的高度值
400	參數類型錯誤	參數類型不正確	確保width和height為數字類型
500	草稿創建失敗	內部服務錯誤	聯繫技術支持
503	服務不可用	系統維護中	稍後重試

注意事項

1. 參數驗證: width和height必須為正整數
2. 分辨率建議: 建議使用常見的視頻分辨率以確保兼容性
3. 性能考慮: 超高分辨率可能影響後續處理性能
4. 存儲佔用: 高分辨率草稿會佔用更多存儲空間
5. URL有效期: 返回的draft_url具有一定的有效期

工作流程

1. 接收並驗證請求參數
2. 創建草稿基礎結構
3. 設置畫布尺寸
4. 生成草稿URL
5. 返回草稿信息和幫助文檔鏈接

相關接口

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

---

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