微秒,不是秒
1 秒 = 1000000。5 秒片段写 start: 0、end: 5000000。填成秒或毫秒,素材会短得看不见或整体错位。
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 元/秒计费。
create_draft
创建草稿,拿到 draft_url;后续每次写请求都要带上它。
add_videos / add_images / add_audios / add_captions
按需多次添加素材;列表字段传 JSON 字符串,时间单位微秒。
add_effects / add_filters / add_keyframes / add_masks
可选:特效、滤镜、关键帧与遮罩。
gen_video
提交异步导出任务(收费,需 apiKey)。
gen_video_status
每 3–5 秒轮询,直到 status 为 completed 或 failed;成功后读 video_url。
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。 接口页里写的是相对路径,实际请求必须拼基地址,否则无法访问。
# 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 单价 | 计算方式 |
|---|---|---|
| 普通用户 | 0.3 元/分钟 | 标准价 |
| VIP 用户 | 0.24 元/分钟 | 0.3 × 0.8 |
| SVIP 用户 | 0.18 元/分钟 | 0.3 × 0.6 |
到 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。填成秒或毫秒,素材会短得看不见或整体错位。
video_infos、audio_infos、image_infos、captions、keyframes 都是字符串,不是对象数组。
先 create_draft,再把返回的 draft_url 原样带在后续请求里; 不要自己拼 draft_id。
{
"draft_url": "YOUR_DRAFT_URL",
"video_infos": "[{\"video_url\":\"https://example.com/clip.mp4\",\"start\":0,\"end\":5000000}]"
}06 / 语音识别
语音识别不属于剪映小助手:基地址 https://autosubrt.jcaigc.cn,路径前缀 /openapi/autosubrt/v1/。四个接口都按音频时长 0.00022 元/秒计费(识别成功后才扣费), 都需要 apiKey,与剪映小助手共用同一套充值余额。
| 接口 | 方法 / 路径 | 说明 |
|---|---|---|
asr | POST /openapi/autosubrt/v1/asr | 完整文案 + 分句 + 逐字时间线(毫秒) |
asr/text | POST /openapi/autosubrt/v1/asr/text | 只返回带标点的纯文本 |
asr/srt | POST /openapi/autosubrt/v1/asr/srt | 直接返回 SRT 文件本体,不是 JSON |
asr/text/align | POST /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/# 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
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 / 常见问题
到 www.jcaigc.cn 获取 API Key 并充值。只有 gen_video 与 upload_file 需要 Key,其余接口免费。
接口页里的路径是相对路径,必须拼上基地址与 /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 接口,不注入、不破解剪映客户端。