简创AIGC官方文档

📖 剪映小助手 API 文档

欢迎使用简创AIGC剪映小助手 API。本文档提供完整的接口说明、调用示例和计费规则，帮助开发者快速接入视频自动化创作服务。

开始调用前，请先确认以下三点：

剪映小助手的 RESTful API 使用统一基地址：https://capcut-mate.jcaigc.cn
仅 gen_video（视频导出，0.3 元/分钟）和 upload_file（文件上传，0.0005 元/MB）收费，其余接口免费
语音识别（ASR）是另一个服务，基地址为 https://autosubrt.jcaigc.cn，按音频时长计费（0.00022 积分/秒），见下方「🎤 语音识别（ASR）」一节

想让 AI 工具直接调用？

下载技能包装进 Claude Code 等支持 Agent Skills 的工具，就能用自然语言生成剪映草稿，不用自己拼 JSON、写 curl。安装步骤见下方「🧩 技能包下载与安装」。

⬇️ 下载剪映小助手

🌐 API 基地址

所有 RESTful API 必须以如下地址作为基地址（Base URL），不能省略，也不能替换为其它域名：

https://capcut-mate.jcaigc.cn

项目	说明
基地址	`https://capcut-mate.jcaigc.cn`
协议	HTTPS
接口路径前缀	`/openapi/capcut-mate/v1/`
完整请求地址	`基地址 + 接口路径`

完整地址拼接规则

完整 URL = https://capcut-mate.jcaigc.cn + /openapi/capcut-mate/v1/{接口名}

示例：

接口	完整请求地址
创建草稿 `create_draft`	`https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/create_draft`
生成视频 `gen_video`	`https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/gen_video`
查询状态 `gen_video_status`	`https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/gen_video_status`

调用注意

文档中各接口页列出的路径（如 POST /openapi/capcut-mate/v1/create_draft）均为相对路径。实际请求时必须拼接基地址，否则无法访问。

语音识别服务的基地址

「🎤 语音识别（ASR）」不是剪映小助手的一部分，基地址与路径前缀都不同，调用时不要拼错：

项目	说明
基地址	`https://autosubrt.jcaigc.cn`
接口路径前缀	`/openapi/autosubrt/v1/`
完整请求地址	`https://autosubrt.jcaigc.cn/openapi/autosubrt/v1/asr` 等

💰 计费说明

接口	是否收费	价格	说明
gen_video（视频导出）	是	0.3 元 / 分钟	按导出视频时长计费
upload_file（文件上传）	是	0.0005 元 / MB	按上传文件实际体积计费（1024 进制，约 0.51 元 / GB），对象存储上传成功后才扣费
语音识别（ASR，另一个服务）	是	0.00022 积分 / 秒	按音频时长计费，识别成功后才扣费
其它全部接口	否	免费	创建草稿、添加素材、查询状态等均可免费调用

上传计费示例：上传一个 100MB 的文件扣 0.05 元，500MB 的文件扣 0.25 元。

语音识别（ASR）属于另一个服务，价格以积分计（与剪映小助手共用同一套积分体系），详见下方「🎤 语音识别（ASR）」。

SVIP 折扣

SVIP 用户在 gen_video 标准价格基础上再打 6 折（即按原价的 60% 结算）。

用户类型	视频导出单价	计算方式
普通用户	0.3 元 / 分钟	标准价
SVIP 用户	0.18 元 / 分钟	`0.3 × 0.6`

计费示例：导出 2 分钟视频，普通用户 0.6 元，SVIP 用户 0.36 元。

API Key 获取与充值

调用接口前请先获取 API Key，并按需充值：

https://www.jcaigc.cn

🎤 语音识别（ASR）

语音识别是独立服务，基地址 https://autosubrt.jcaigc.cn，路径前缀 /openapi/autosubrt/v1/：把音频转成文案、SRT 字幕或时间线。四个接口都按音频时长计费（0.00022 积分/秒，识别成功后才扣费），都需要 apiKey。

接口	路径	说明
语音转文案	`POST /openapi/autosubrt/v1/asr`	完整文案 + 分句 + 逐字时间线（毫秒）
语音转文本	`POST /openapi/autosubrt/v1/asr/text`	只返回带标点的纯文本
语音转 SRT 字幕	`POST /openapi/autosubrt/v1/asr/srt`	直接返回 SRT 文件本体，不落盘
文本对齐时间线	`POST /openapi/autosubrt/v1/asr/text/align`	按音频对齐你给的文本，返回行级时间线（微秒）

计费示例：10 秒音频 0.002200 积分，60 秒 0.013200 积分，1 小时 0.792000 积分。调用前账户积分需大于 1。

与剪映小助手配合

用文本对齐时间线拿到字幕行后，时间线单位正好是微秒，可直接作为 start / end 交给剪映小助手的 add_captions，得到带字幕的草稿。

🤖 模型 / Agent 接入

大模型请不要抓取整站 HTML。从发现入口开始：

llms.txt — 硬规则与分组链接（llmstxt.org）
调用指南 — 调用顺序、微秒、JSON 字符串、异步导出
精简契约 — 核心写接口的最小请求体

时间单位为微秒（1 秒 = 1000000）。列表字段（video_infos 等）是 JSON 字符串。写接口必须携带 create_draft 返回的 draft_url。

如果把下面的技能包装进 AI 工具，以上规则会由工具自动遵守，你直接用自然语言提需求即可。

🧩 技能包下载与安装

剪映小助手是一套 Agent Skill。下载 zip 并安装到支持技能的 AI 工具后，直接用自然语言就能驱动剪映草稿的创建与导出，不必自己拼 JSON、写 curl。

下载地址固定为 /downloads/jianchuang-jianying-assistant.zip。更新技能时只替换这一个文件，不必重新发布整站文档。

⬇️ 下载剪映小助手

也可以直接命令行下载：

bash

curl -L -o jianchuang-jianying-assistant.zip https://docs.jcaigc.cn/downloads/jianchuang-jianying-assistant.zip

项目	说明
文件名	`jianchuang-jianying-assistant.zip`
技能名	`jianchuang-jianying-assistant`（写在 `SKILL.md` 开头的 `name` 字段，解压后的目录名要与它一致）
文件大小	约 295 KB
包内结构	`jianchuang-jianying-assistant/SKILL.md`，以及 `references/`、`scripts/`
适用工具	Claude Code、Claude 网页版/桌面版，以及 Cursor、GitHub Copilot、Gemini CLI、Codex CLI、Windsurf 等支持 Agent Skills 的工具
前置条件	脚本需要 Node.js 18+；仅导出视频（`gen_video`）需要自备 `apiKey`
下载地址	`https://docs.jcaigc.cn/downloads/jianchuang-jianying-assistant.zip`

zip 解压后的顶层就是技能目录，不要再套一层：

jianchuang-jianying-assistant/
├─ SKILL.md
├─ references/
└─ scripts/

安装到 Claude Code（CLI / IDE 插件）

方式一：个人级技能（所有项目都能用）

bash

# 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

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"

方式二：项目级技能（只在当前项目生效）

把同一个 zip 解压到项目根目录的 .claude/skills/：

你的项目/
└─ .claude/
   └─ skills/
      └─ jianchuang-jianying-assistant/
         ├─ SKILL.md
         ├─ references/
         └─ scripts/

放好之后新开一个会话（或执行 /exit 后重新进入），技能才会被加载。

装不上时先看这两条

目录名必须是 jianchuang-jianying-assistant，和 SKILL.md 里的 name 一致。不要改名，也不要多套一层文件夹。
SKILL.md 必须是大写。Windows / macOS 默认不区分大小写，改成 skill.md 本地看着能用，但在 Linux 上会直接失效。

安装到 Claude 网页版 / 桌面版

网页版与桌面版直接上传这个 zip，不用自己再打包：

先在**设置 → 能力（Capabilities）**里打开「代码执行与文件创建」——不开这个开关，技能无法运行。
进入 自定义（Customize）→ 技能（Skills）→ 创建技能 → 上传技能，选择下载好的 jianchuang-jianying-assistant.zip。
上传后把该技能打开开关。

技能不会跨产品同步

在网页版上传的技能，不会出现在 Claude Code 里；反过来也一样。两边都要用，就各自安装一次。

安装到其它 AI 工具

解压后的目录换到别的工具也能用，规则一样：目录名保持 jianchuang-jianying-assistant，区别只是放在哪个目录。

工具	放置位置
Cursor	项目内 `.cursor/skills/jianchuang-jianying-assistant/`；用户级 `~/.cursor/skills/jianchuang-jianying-assistant/`
GitHub Copilot	项目内 `.github/skills/jianchuang-jianying-assistant/`；用户级 `~/.copilot/skills/jianchuang-jianying-assistant/`
Gemini CLI	工作区 `.gemini/skills/jianchuang-jianying-assistant/`；用户级 `~/.gemini/skills/jianchuang-jianying-assistant/`
Codex CLI	仓库内 `.agents/skills/jianchuang-jianying-assistant/`；用户级 `~/.agents/skills/jianchuang-jianying-assistant/`
Windsurf	工作区 `.windsurf/skills/jianchuang-jianying-assistant/`；全局 `~/.codeium/windsurf/skills/jianchuang-jianying-assistant/`

以各工具官方文档为准

各工具的「技能（Skills）」目录约定仍在演进，上表仅供参考。安装前请查一下该工具官方文档里 Skills / 技能一章；如果你的工具不在表里，在设置里搜 “Skills” 也能找到对应目录。此外 .agents/skills/ 正逐渐成为跨工具的通用位置，但 Claude Code 只读 .claude/skills/。

验证是否安装成功

Claude Code 里可以先执行 /skills（或 /context），确认列表中出现 jianchuang-jianying-assistant。

然后提一句带触发词的需求，比如：

用剪映小助手创建一个 1080x1920 的竖屏草稿，加一段 5 秒视频

AI 应该会自动读取该技能并调用 /create_draft、/add_videos 等接口。如果它反过来问你“接口地址是什么”，说明技能没被加载，请检查目录名和层级是否正确。

使用提示

技能里已写明硬规则：Base URL、微秒、draft_url、列表字段是 JSON 字符串、异步轮询等，无需你再向 AI 解释。
收费接口只有 gen_video（导出，0.3 元/分钟）和 upload_file（上传，0.0005 元/MB），都需要 apiKey。请先到 https://www.jcaigc.cn 获取并充值，调用时把 Key 交给 AI 即可。
想要更细的接口参数，让 AI 直接读本站文档页，或参考调用指南与精简契约。

🔧 核心功能

自动化视频创作 — 通过 API 自动创建和编辑视频，提升制作效率
批量素材处理 — 支持同时处理多个视频、音频、图片素材
丰富的特效支持 — 提供转场、遮罩、滤镜等多种视频特效
灵活的时间轴控制 — 精确控制素材在时间轴上的位置和持续时间

📚 文档导航

🤖 模型接入

🚀 快速开始

🎞️ 视频处理

🎨 效果增强

📤 输出发布

🎤 语音识别（ASR）

🛠️ 技术支持

如果您在使用过程中遇到任何问题，请通过以下方式联系我们：

📧 邮箱支持: 16620803786@163.com
📖 官方文档: https://docs.jcaigc.cn
🔑 API Key 获取 & 充值: https://www.jcaigc.cn
💬 开发者社区: GitHub讨论区

📚 项目资源
GitHub | Gitee | 官方文档 | 获取 API Key

简创AIGC官方文档 ​

📖 剪映小助手 API 文档 ​

🌐 API 基地址 ​

完整地址拼接规则 ​

语音识别服务的基地址 ​

💰 计费说明 ​

SVIP 折扣 ​

API Key 获取与充值 ​

🎤 语音识别（ASR） ​

🤖 模型 / Agent 接入 ​

🧩 技能包下载与安装 ​

安装到 Claude Code（CLI / IDE 插件） ​

安装到 Claude 网页版 / 桌面版 ​

安装到其它 AI 工具 ​

验证是否安装成功 ​

使用提示 ​

🔧 核心功能 ​

📚 文档导航 ​

🤖 模型接入

🚀 快速开始

🎞️ 视频处理

🎨 效果增强

📤 输出发布

🎤 语音识别（ASR）

🛠️ 技术支持 ​

简创AIGC官方文档

📖 剪映小助手 API 文档

🌐 API 基地址

完整地址拼接规则

语音识别服务的基地址

💰 计费说明

SVIP 折扣

API Key 获取与充值

🎤 语音识别（ASR）

🤖 模型 / Agent 接入

🧩 技能包下载与安装

安装到 Claude Code（CLI / IDE 插件）

安装到 Claude 网页版 / 桌面版

安装到其它 AI 工具

验证是否安装成功

使用提示

🔧 核心功能

📚 文档导航

🛠️ 技术支持