简创AIGC官方文档

主题切换

模型调用指南 ​

🌐 语言切换 ​

中文版 | English

面向大模型 / Agent 的调用说明。人类完整接口文档见侧栏；本页只写自动调用必须遵守的规则。

硬规则 ​

  1. Base URL 必须是 https://capcut-mate.jcaigc.cn，路径前缀 /openapi/capcut-mate/v1/。
  2. 时间单位是微秒：1 秒 = 1000000。例如 5 秒片段写 start: 0, end: 5000000。
  3. 先 create_draft，后续每次写接口带上返回的 draft_url。不要自己编 draft_id。
  4. 列表字段是 JSON 字符串，不是对象数组：video_infos、audio_infos、image_infos、captions、keyframes、effect_infos、filter_infos。
  5. 收费接口只有 gen_video（导出，0.3 元/分钟）和 upload_file（上传，0.0005 元/MB），都需要 apiKey（UUID）。其余接口免费。
  6. 导出是异步：gen_video 只表示任务已提交，必须轮询 gen_video_status。

默认工作流 ​

  1. POST /create_draft → 拿到 draft_url
  2. 按需要多次调用 add_videos / add_images / add_audios / add_captions
  3. 可选：add_effects / add_filters / add_keyframes / add_masks
  4. POST /gen_video（线上导出带 apiKey）
  5. 每 3–5 秒 POST /gen_video_status，直到 status 为 completed 或 failed
  6. 成功后使用响应里的 video_url
mermaid
flowchart LR
  createDraft[create_draft] --> addMedia["add_videos / add_audios / add_images / add_captions"]
  addMedia --> genVideo[gen_video]
  genVideo --> poll[gen_video_status]
  poll -->|pending or processing| poll
  poll -->|completed| videoUrl[video_url]

不要主动调用 ​

以下接口是给扣子 / n8n 拼 JSON 字符串用的，原生 function calling 不要调用：

  • timelines、audio_timelines
  • video_infos、audio_infos、imgs_infos、caption_infos、effect_infos、filter_infos、keyframes_infos
  • str_to_list、str_list_to_objs、objs_to_str_list

直接构造 JSON 字符串传给 add_* 即可。

最小示例：竖屏短视频 ​

bash
# 1. 创建 1080x1920 草稿
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft \
  -H "Content-Type: application/json" \
  -d '{"width":1080,"height":1920}'

# 2. 添加 5 秒视频（把 YOUR_DRAFT_URL 换成上一步的 draft_url）
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/add_videos \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL",
    "video_infos": "[{\"video_url\":\"https://example.com/clip.mp4\",\"start\":0,\"end\":5000000}]"
  }'

# 3. 提交导出
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","apiKey":"123e4567-e89b-12d3-a456-426614174000"}'

# 4. 查询状态，直到 completed
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/gen_video_status \
  -H "Content-Type: application/json" \
  -d '{"draft_url":"YOUR_DRAFT_URL"}'

状态机 ​

status含义下一步
pending排队中继续轮询
processing渲染中继续轮询
completed成功读取 video_url
failed失败读取 error_message，不要死循环

相关文档 ​

版权所有 © 2025 简创AIGC