跳到主要内容

DOCS / 剪映小助手 · CapCut Mate

剪映小助手技能文档

把「创建草稿 → 添加素材 → 导出成片」做成一套 HTTP 接口。本页是官方文档的速查版: 基地址与拼接、计费与折扣、全部接口名、数据结构、ASR 独立服务与技能包安装。

接口基地址capcut-mate.jcaigc.cn
路径前缀/openapi/capcut-mate/v1/
时间单位微秒(1 秒 = 1000000)
收费接口gen_video / upload_file
技能包jianchuang-jianying-assistant

01 / 概览

开始调用前,先确认三件事

三个前提

① 统一基地址 https://capcut-mate.jcaigc.cn,路径前缀 /openapi/capcut-mate/v1/; ② 只有 gen_video(导出,0.3 元/分钟)与 upload_file(上传,0.005 元/MB)收费,其余免费; ③ 语音识别 ASR 是另一个服务(https://autosubrt.jcaigc.cn),按 0.00022 元/秒计费。

默认工作流

  1. 01

    create_draft

    创建草稿,拿到 draft_url;后续每次写请求都要带上它。

  2. 02

    add_videos / add_images / add_audios / add_captions

    按需多次添加素材;列表字段传 JSON 字符串,时间单位微秒。

  3. 03

    add_effects / add_filters / add_keyframes / add_masks

    可选:特效、滤镜、关键帧与遮罩。

  4. 04

    gen_video

    提交异步导出任务(收费,需 apiKey)。

  5. 05

    gen_video_status

    每 3–5 秒轮询,直到 status 为 completed 或 failed;成功后读 video_url。

想直接让 AI 工具调用?读 调用指南 与 精简契约,或下载技能包; 发现入口是 llms.txt。

02 / 基地址

基地址与拼接规则

项目说明
基地址https://capcut-mate.jcaigc.cn
协议HTTPS
接口路径前缀/openapi/capcut-mate/v1/
完整请求地址基地址 + 接口路径
拼接公式
完整 URL = https://capcut-mate.jcaigc.cn + /openapi/capcut-mate/v1/{接口名}

例如创建草稿:https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft; 查询状态:https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/gen_video_status。 接口页里写的是相对路径,实际请求必须拼基地址,否则无法访问。

最小调用示例

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 秒视频(video_infos 是 JSON 字符串,单位为微秒)
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. 提交导出并轮询状态(导出收费,需 apiKey)
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":"YOUR_API_KEY"}'

03 / 计费

计费与会员折扣

接口是否收费价格说明
gen_video(导出)收费0.3 元/分钟按导出视频时长计费
upload_file(上传)收费0.005 元/MB按实际体积(1024 进制,约 5.12 元/GB),上传成功后才扣费
asr(另一个服务)收费0.00022 元/秒按音频时长计费,识别成功后才扣费
其它全部接口免费0创建草稿、添加素材、查询状态等

会员折扣(只作用于 gen_video)

用户类型gen_video 单价计算方式
普通用户0.3 元/分钟标准价
VIP 用户0.24 元/分钟0.3 × 0.8
SVIP 用户0.18 元/分钟0.3 × 0.6

API Key 获取与充值

到 www.jcaigc.cn 获取 API Key 并按需充值。导出 2 分钟视频:普通 0.6 元、VIP 0.48 元、SVIP 0.36 元。upload_file 与网关 API 不参与会员折扣;VVIP 由运营单独开通。

04 / 接口

接口清单

接口名即路径最后一段,统一拼在 /openapi/capcut-mate/v1/ 之后。 计费接口只有 gen_video 与 upload_file,其余免费。

分类接口一句话说明
草稿与导出create_draft创建草稿(默认 1920×1080),返回 draft_url。
get_draft获取草稿信息;draft_url 自带 draft_id。
save_draft保存草稿改动;多数写接口会自动落盘。
gen_video提交异步导出任务(0.3 元/分钟,需 apiKey)。
gen_video_status轮询状态:pending / processing / completed / failed。
gen_video_active_count查询进行中的导出任务数量。
easy_create_material一次加入音频、视频、图片、文字(audio_url 必填)。
添加素材add_audios批量添加音频;audio_infos 为 JSON 字符串。
add_beauty给人像片段加美颜。
add_captions批量添加字幕;captions 为 JSON 字符串。
add_effects添加特效;effect_infos 为 JSON 字符串。
add_filters添加滤镜;filter_infos 为 JSON 字符串。
add_images添加图片;image_infos 为 JSON 字符串。
add_keyframes添加关键帧;keyframes 为 JSON 字符串。
add_masks给已有片段加遮罩(按 segment_ids)。
add_mask_keyframes给遮罩加关键帧。
add_sticker添加贴纸;sticker_id 来自 search_sticker。
add_text_style设置文字字体、颜色、描边等样式。
add_videos批量添加视频;video_infos 为 JSON 字符串。
查询与工具get_audio_duration查询音频时长,用于排时间轴。
get_effects查询可用特效,取 effect_title。
get_filters查询可用滤镜,取 filter_title。
get_image_animations查询图片动画。
get_text_animations查询文字动画。
get_text_effects查询花字 / 文字特效。
get_url从文本里提取链接。
search_sticker搜索贴纸,取 sticker_id。
upload_file上传文件到对象存储(0.005 元/MB,需 apiKey)。
字符串工具str_list_to_objs字符串列表 → 对象数组字符串。
objs_to_str_list对象数组字符串 → 字符串列表。
str_to_list把字符串拆成列表。
账户get_points查询账户余额。

数据结构与字符串工具接口是给扣子 / n8n 拼 JSON 字符串用的,原生 function calling 不要主动调用:直接构造 JSON 字符串传给 add_* 即可。

05 / 数据结构

数据结构与三个必踩的坑

结构说明
audio_infos音频素材:audio_url、start、end 等。
audio_timelines音频时间线(扣子 / n8n 拼装用)。
caption_infos字幕条目:text 与起止时间(微秒)。
effect_infos特效条目:特效名与起止时间。
filter_infos滤镜条目:滤镜名、强度与起止时间。
imgs_infos图片素材:image_url、start、end 等。
keyframes_infos关键帧条目:属性、时间点与值。
timelines视频 / 图片时间线(扣子拼装用)。
video_infos视频素材:video_url、start、end,可选 duration、volume、transition。

三个必踩的坑

微秒,不是秒

1 秒 = 1000000。5 秒片段写 start: 0、end: 5000000。填成秒或毫秒,素材会短得看不见或整体错位。

列表字段是 JSON 字符串

video_infos、audio_infos、image_infos、captions、keyframes 都是字符串,不是对象数组。

写接口必须带 draft_url

先 create_draft,再把返回的 draft_url 原样带在后续请求里; 不要自己拼 draft_id。

正确的 video_infos 写法
{
  "draft_url": "YOUR_DRAFT_URL",
  "video_infos": "[{\"video_url\":\"https://example.com/clip.mp4\",\"start\":0,\"end\":5000000}]"
}

06 / 语音识别

ASR:另一个服务

语音识别不属于剪映小助手:基地址 https://autosubrt.jcaigc.cn,路径前缀 /openapi/autosubrt/v1/。四个接口都按音频时长 0.00022 元/秒计费(识别成功后才扣费), 都需要 apiKey,与剪映小助手共用同一套充值余额。

接口方法 / 路径说明
asrPOST /openapi/autosubrt/v1/asr完整文案 + 分句 + 逐字时间线(毫秒)
asr/textPOST /openapi/autosubrt/v1/asr/text只返回带标点的纯文本
asr/srtPOST /openapi/autosubrt/v1/asr/srt直接返回 SRT 文件本体,不是 JSON
asr/text/alignPOST /openapi/autosubrt/v1/asr/text/align按音频对齐文本,时间线为微秒

毫秒 / 微秒别记混

/asr 返回毫秒,/asr/text/align 返回微秒,两者相差 1000 倍。 文本对齐时间线可直接作为 start / end 交给 add_captions,拼出带字幕的草稿。

07 / 技能包

下载与安装

项目说明
文件名jianchuang-jianying-assistant.zip
技能名写在 SKILL.md 的 name 字段;解压后的目录名要与它一致
包内结构SKILL.md + references/ + scripts/
前置条件脚本需要 Node.js 18+;仅 gen_video 需要自备 apiKey
适用工具Claude Code、Claude 网页版 / 桌面版,Cursor、GitHub Copilot、Gemini CLI、Codex CLI、Windsurf 等

目录结构

解压后只套一层
jianchuang-jianying-assistant/
├─ SKILL.md
├─ references/
└─ scripts/

安装到 Claude Code

Windows · PowerShell
# Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills"
curl.exe -L -o "$env:TEMP\jianchuang-jianying-assistant.zip" https://docs.jcaigc.cn/downloads/jianchuang-jianying-assistant.zip
Expand-Archive -Force -Path "$env:TEMP\jianchuang-jianying-assistant.zip" -DestinationPath "$env:USERPROFILE\.claude\skills"
macOS / Linux
# macOS / Linux
mkdir -p ~/.claude/skills
curl -L -o /tmp/jianchuang-jianying-assistant.zip https://docs.jcaigc.cn/downloads/jianchuang-jianying-assistant.zip
unzip -o /tmp/jianchuang-jianying-assistant.zip -d ~/.claude/skills

项目级安装:把 zip 解压到项目根目录的 .claude/skills/。其它工具只需换目录: Cursor .cursor/skills/、GitHub Copilot .github/skills/、 Gemini CLI .gemini/skills/、Codex CLI .agents/skills/、 Windsurf .windsurf/skills/;目录名都保持 jianchuang-jianying-assistant。

装不上先看这两条

目录名必须是 jianchuang-jianying-assistant,也不要多套一层文件夹;SKILL.md 必须大写。装好后新开会话(或 /exit 重进), 在 Claude Code 里用 /skills 确认列表中出现它。

08 / 常见问题

常见问题

API Key 在哪里获取?

到 www.jcaigc.cn 获取 API Key 并充值。只有 gen_video 与 upload_file 需要 Key,其余接口免费。

为什么调用返回 404?

接口页里的路径是相对路径,必须拼上基地址与 /openapi/capcut-mate/v1/ 前缀;ASR 的地址在另一个域名。

导出怎么计费?

gen_video 0.3 元/分钟,VIP 0.8 折、SVIP 0.6 折;upload_file 0.005 元/MB。轮询状态不收费。

传数组为什么报错?

video_infos、audio_infos、captions 等字段要求 JSON 字符串,不是对象数组。

字幕时间错位?

剪映小助手用微秒(1 秒 = 1000000);ASR 的 /asr 返回毫秒、/asr/text/align 返回微秒,相差 1000 倍。

导出一提交就没结果?

导出是异步的:每 3–5 秒轮询 gen_video_status,直到 completed 或 failed;failed 读 error_message 后停止。

本页依据官方文档整理,接口参数、价格与可用性以 docs.jcaigc.cn/capcut-mate 为准。剪映小助手为第三方开源服务;鸣雀创作只调用公开 HTTP 接口,不注入、不破解剪映客户端。