# CapCut Mate

> 剪映草稿自动化 API。Base URL: https://capcut-mate.jcaigc.cn 。路径前缀: /openapi/capcut-mate/v1/ 。时间单位为微秒（1秒=1000000）。会话状态键为 draft_url。仅 gen_video（导出，0.3 元/分钟）和 upload_file（上传，0.0005 元/MB）收费并需要 apiKey，其余接口免费。
> 语音识别（ASR）是独立服务，Base URL: https://autosubrt.jcaigc.cn 。路径前缀: /openapi/autosubrt/v1/ 。按音频时长收费（0.00022 积分/秒），需要 apiKey。

所有写接口必须携带 create_draft 返回的 draft_url，禁止自行拼接 draft_id。
video_infos / audio_infos / image_infos / captions 等列表字段是 JSON 字符串，不是对象数组。
导出是异步：gen_video 后轮询 gen_video_status，直到 status=completed 或 failed。
扣子拼装辅助接口（*_infos、timelines、str_to_list）在原生 function calling 中不要主动调用。
ASR 的时间单位分两种：/asr 返回毫秒，/asr/text/align 返回微秒（可直接用于 add_captions）。

## 技能文件（Agent Skill）

- [剪映小助手技能包](https://docs.jcaigc.cn/downloads/jianchuang-jianying-assistant.zip): 可直接下载的 Agent Skill 压缩包（name: jianchuang-jianying-assistant）。安装到 Claude Code 等支持技能的工具后，可用自然语言驱动剪映草稿创建与导出；下载与安装说明见 https://docs.jcaigc.cn/

## 模型调用

- [调用指南](https://docs.jcaigc.cn/guide/llm-guide.zh.md): 调用顺序、硬规则与最小示例
- [精简契约](https://docs.jcaigc.cn/guide/llm-contract.zh.md): 核心写接口的方法、必填字段与最小 JSON

## 核心流程

- [创建草稿](https://docs.jcaigc.cn/docs/create_draft.zh.md): 返回后续必须携带的 draft_url
- [添加视频](https://docs.jcaigc.cn/docs/add_videos.zh.md): video_infos 为 JSON 字符串，时间为微秒
- [添加音频](https://docs.jcaigc.cn/docs/add_audios.zh.md): audio_infos 为 JSON 字符串，时间为微秒
- [添加图片](https://docs.jcaigc.cn/docs/add_images.zh.md): image_infos 为 JSON 字符串，时间为微秒
- [添加字幕](https://docs.jcaigc.cn/docs/add_captions.zh.md): captions 为 JSON 字符串，时间为微秒
- [生成视频](https://docs.jcaigc.cn/docs/gen_video.zh.md): 异步提交导出任务，可带 apiKey
- [查询导出状态](https://docs.jcaigc.cn/docs/gen_video_status.zh.md): pending / processing / completed / failed

## 增强能力

- [添加特效](https://docs.jcaigc.cn/docs/add_effects.zh.md)
- [添加滤镜](https://docs.jcaigc.cn/docs/add_filters.zh.md)
- [添加关键帧](https://docs.jcaigc.cn/docs/add_keyframes.zh.md)
- [添加遮罩](https://docs.jcaigc.cn/docs/add_masks.zh.md)
- [添加蒙版关键帧](https://docs.jcaigc.cn/docs/add_mask_keyframes.zh.md)
- [添加美颜](https://docs.jcaigc.cn/docs/add_beauty.zh.md)
- [添加贴纸](https://docs.jcaigc.cn/docs/add_sticker.zh.md)
- [添加文本样式](https://docs.jcaigc.cn/docs/add_text_style.zh.md)
- [保存草稿](https://docs.jcaigc.cn/docs/save_draft.zh.md)
- [获取草稿](https://docs.jcaigc.cn/docs/get_draft.zh.md)
- [快速创建素材](https://docs.jcaigc.cn/docs/easy_create_material.zh.md)

## 语音识别（ASR）

独立服务，Base URL https://autosubrt.jcaigc.cn ，路径前缀 /openapi/autosubrt/v1/ 。按音频时长计费（0.00022 积分/秒，识别成功后才扣费），需要 apiKey。

- [语音转文案](https://docs.jcaigc.cn/docs/asr.zh.md): 完整文案 + 分句 + 逐字时间线（毫秒）
- [语音转文本](https://docs.jcaigc.cn/docs/asr_text.zh.md): 只返回带标点的纯文本
- [语音转 SRT 字幕](https://docs.jcaigc.cn/docs/asr_srt.zh.md): 直接返回 SRT 文件本体（Content-Type: application/x-subrip，不是 JSON）
- [文本对齐时间线](https://docs.jcaigc.cn/docs/asr_text_align.zh.md): 按音频对齐你给的文本，时间线单位为微秒，可直接作为 add_captions 的 start / end

## Optional

- [全文镜像](https://docs.jcaigc.cn/llms-full.txt): 中文接口文档合集
- [查询动画与特效](https://docs.jcaigc.cn/docs/get_text_animations.zh.md)
- [查询图片动画](https://docs.jcaigc.cn/docs/get_image_animations.zh.md)
- [查询花字](https://docs.jcaigc.cn/docs/get_text_effects.zh.md)
- [查询滤镜列表](https://docs.jcaigc.cn/docs/get_filters.zh.md): 取 add_filters 可用的 filter_title
- [查询特效列表](https://docs.jcaigc.cn/docs/get_effects.zh.md): 取 add_effects 可用的 effect_title
- [搜索贴纸](https://docs.jcaigc.cn/docs/search_sticker.zh.md)
- [扣子用 OpenAPI](https://github.com/Hommy-master/capcut-mate/blob/main/openapi.yaml): 工作流导入，体积大，不适合直接塞进模型上下文
- [调用指南（English）](https://docs.jcaigc.cn/guide/llm-guide.md)
- [精简契约（English）](https://docs.jcaigc.cn/guide/llm-contract.md)