---
url: /capcut-mate.md
description: >-
  开源剪映小助手（capcut-mate）API 文档。基地址
  https://capcut-mate.jcaigc.cn，提供草稿创建、素材添加、特效字幕与视频导出全链路接口；仅 gen_video（0.3
  元/分钟）与 upload_file（0.005 元/MB）计费，其余接口免费。语音识别（ASR）是另一个服务，基地址
  https://autosubrt.jcaigc.cn，按 0.00022 元/秒计费。
---

# 开源剪映小助手

[← 返回全部能力](/)

## 📖 剪映小助手 API 文档

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

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

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

::: tip 想让 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` |

::: warning 调用注意
文档中各接口页列出的路径（如 `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](/capcut-mate/gen_video.zh.html)（视频导出） | 是 | **0.3 元/分钟** | 按导出视频时长计费 |
| [upload\_file](/capcut-mate/upload_file.zh.html)（文件上传） | 是 | **0.005 元/MB** | 按上传文件实际体积计费（1024 进制，约 5.12 元/GB），对象存储上传成功后才扣费 |
| [语音识别](/capcut-mate/asr.zh.html)（ASR，另一个服务） | 是 | **0.00022 元/秒** | 按音频时长计费，识别成功后才扣费 |
| 其它全部接口 | 否 | **免费** | 创建草稿、添加素材、查询状态等均可免费调用 |

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

语音识别（ASR）属于另一个服务，价格以**元**计（与剪映小助手共用同一套充值余额），详见下方「🎤 语音识别（ASR）」。

### 会员折扣

会员折扣只作用于 `gen_video`（产品页称「剪映草稿云渲染」）：**VIP 8 折、SVIP 6 折**。`upload_file` 以及网关 API（大语言模型、图像、视频生成、语音等）按价目表单价计费，不参与会员折扣。

| 用户类型 | gen\_video 单价 | 计算方式 |
|----------|----------------|----------|
| 普通用户 | 0.3 元/分钟 | 标准价 |
| VIP 用户 | 0.24 元/分钟 | `0.3 × 0.8` |
| SVIP 用户 | 0.18 元/分钟 | `0.3 × 0.6` |

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

VVIP（尊享）由运营单独开通，是会员的最高档位，`gen_video` 按约定折扣结算，具体折扣与有效期以账户开通记录为准。会员只有一档，VVIP 不与其他档位叠加。

### API Key 获取与充值

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

**<https://www.jcaigc.cn>**

***

## 🎤 语音识别（ASR）

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

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

计费示例：10 秒音频 0.002200 元，60 秒 0.013200 元，1 小时 0.792000 元。

::: tip 时间单位有两种，别记混
`/asr` 返回的是**毫秒**，`/asr/text/align` 返回的是**微秒**，两者相差 1000 倍。
:::

::: tip 与剪映小助手配合
用[文本对齐时间线](/capcut-mate/asr_text_align.zh.html)拿到字幕行后，时间线单位正好是微秒，可直接作为 `start` / `end` 交给剪映小助手的 [add\_captions](/capcut-mate/add_captions.zh.html)，得到带字幕的草稿。
:::

需要的是**网关**侧的语音能力（`https://api.jcaigc.cn/v1` 下的识别转写与语音合成），见[语音板块](/voice/)。

***

## 🤖 模型 / Agent 接入

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

* [llms.txt](/llms.txt) — 硬规则与分组链接（llmstxt.org）
* [调用指南](/capcut-mate/llm-guide.zh) — 调用顺序、微秒、JSON 字符串、异步导出
* [精简契约](/capcut-mate/llm-contract.zh) — 核心写接口的最小请求体

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

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

***

## 🧩 技能包下载与安装

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

下载地址固定为 [`/downloads/jianchuang-jianying-assistant.zip`](/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` 后重新进入），技能才会被加载。

::: warning 装不上时先看这两条

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

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

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

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

::: tip 技能不会跨产品同步
在网页版上传的技能，不会出现在 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/` |

::: warning 以各工具官方文档为准
各工具的「技能（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.005 元/MB），都需要 `apiKey`。请先到 <https://www.jcaigc.cn> 获取并充值，调用时把 Key 交给 AI 即可。
* 想要更细的接口参数，让 AI 直接读本站文档页，或参考[调用指南](/capcut-mate/llm-guide.zh)与[精简契约](/capcut-mate/llm-contract.zh)。

***

## 🔧 核心功能

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

***

## 📚 文档导航

***

## 🛠️ 技术支持

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

* 📧 邮箱支持: 16620803786@163.com
* 📖 官方文档: <https://docs.jcaigc.cn>
* 🔑 API Key 获取 & 充值: <https://www.jcaigc.cn>
* 💬 开发者社区: [GitHub讨论区](https://github.com/Hommy-master/capcut-mate/discussions)

***

📚 **项目资源**\
[GitHub](https://github.com/Hommy-master/capcut-mate) | [Gitee](https://gitee.com/taohongmin-gitee/capcut-mate) | [官方文档](https://docs.jcaigc.cn) | [获取 API Key](https://www.jcaigc.cn)

版权所有 © 2025 简创AIGC
