# ADD_EFFECTS API 接口文档 ## 🌐 语言切换 [中文版](./add_effects.zh.md) | [English](./add_effects.md) ## 接口信息 ```bash POST /openapi/capcut-mate/v1/add_effects ``` ## 功能描述 向现有草稿中添加视频特效。该接口用于在指定的时间段内添加特效素材到剪映草稿中，支持多种特效类型如边框特效、滤镜特效、动态特效等。特效可以用于增强视频的视觉效果。 ## 请求参数 ```json { "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258", "effect_infos": "[{\"effect_title\": \"录制边框 III\", \"start\": 0, \"end\": 5000000}, {\"effect_title\": \"简约边框\", \"start\": 2000000, \"end\": 7000000}]" } ``` ### 参数说明 | 参数名 | 类型 | 必填 | 默认值 | 说明 | |--------|------|------|--------|------| | draft_url | string | ✅ | - | 目标草稿的完整URL | | effect_infos | string | ✅ | - | 特效信息列表的JSON字符串 | ### 参数详解 #### effect_infos 字段格式 `effect_infos` 是一个JSON字符串，包含特效信息数组，每个特效对象包含以下字段： ```json [ { "effect_title": "录制边框 III", // 特效名称/标题，必选参数 "start": 0, // 特效开始时间（微秒），必选参数 "end": 5000000 // 特效结束时间（微秒），必选参数 } ] ``` **字段说明**: - `effect_title`: 特效名称，须为下方「支持的特效名称」列表中的值 - `start`: 特效开始时间，单位为微秒，必须大于等于0 - `end`: 特效结束时间，单位为微秒，必须大于start #### 时间参数 - **start**: 特效在时间轴上的开始时间，单位为微秒（1秒 = 1,000,000微秒） - **end**: 特效在时间轴上的结束时间，单位为微秒 - **duration**: 特效显示时长 = end - start ### 支持的特效名称（effect_title 可用值） 下列名称可直接作为 `effect_title` 的值（与剪映特效展示名一致，来自画面特效与人物特效）。未匹配到时添加会失败。 当前共 **1328** 种（画面特效 1097 + 人物特效 240，去重后）： ```text 1998 2024边框 2025气球泡泡 360运镜 360运镜 II 3D兔兔 3D春联 3D环绕 3D环绕屏 70s 90s画质 betamax Bling飘落 BOOM！ C300 CCD闪光 crash！ DV录制框 DV界面 emoji钻石 I Lose You I Love You Ins描边 ins界面 ins风放大镜 IXUS JVC kirakira ktv灯光 ktv灯光 II List边框 Love u MV封面 New Year PASSION PS边框 RGB描边 S形运镜 VCR W830 windows弹窗关闭 windows弹窗打开 X X-Signal X开幕 X瞬移 一刀两断 丁达尔光线 丁达尔旋焦 万向镜像 万圣emoji 万圣夜 三屏 三格漫画 三段式黑白 上上签 下雨 下雨涟漪 不对劲 不规则黑框 丝印涂鸦 丝滑运镜 两屏 两屏分割 中刀 中枪了 中轴旋转 主体冲破屏幕 乌鸦飞过 九尾狐 九屏 九屏跑马灯 二次元运镜 云朵绵绵 五彩纸屑 五彩缤纷 五星好评 交叉震闪 亮片 人影爆闪 人鱼滤镜 仙女变身 仙女变身 II 仙女棒 仙女棒II 仙尘闪闪 低保真 低像素 低像素 II 侧移模糊 信号干扰 倒带 倒计时 倒计时 II 倒计时 III 倒计时II 假日闪闪 Ⅱ 像素屏闪 像素扫描 像素拉伸 II 像素排序 像素故障 像素爱心 像素画 像素纹理 像素震闪 光斑虚化 光斑飘落 光晕 光晕 II 光环 I 光环 II 光线扫描 光线拖影 光谱扫描 兔个好彩头 兔兔碎闪 兔年红包 全剧终 全屏烟花 全屏祝福语 全息扫描 六屏 关月亮 冰冷实验室 冰霜 冰霜 II 冲击波 冲刺 冲刺 II 冲刺 III 冲屏闪粉 凄凉 几何图形 几何拖尾 I 几何拖尾 II 击中 刀光剑影 分区显色 分头行动 分屏开幕 分屏漏光 分身 分身 III 分身ll 初雪 I 剪纸窗花 剪纸边框 加载甜蜜 动态侦测 动态格 动感光束 动感变焦 动感扫光 动感推镜 动感模糊 动感爱心 动感竖线 动感色卡 动感荧光 动感蓝带 动感运镜 十字模糊 十字爆闪 单向移动 单彩渐变 单色填充 单色涂鸦 南瓜光斑 南瓜笑脸 卡机 卡通渲染 卡通脸 卷动 卷轴打开 厚卡纸 原相机 原相机拉近 原相机滤镜 原相机缩放 友友商店 双重辉光 反转片 I 发光 发光 II 发光HDR 发光分身 取景器 取景框 取景框 II 变形了 变彩色 变清晰 变清晰 II 变焦推镜 变焦烟花 变秋天 变老-美颜 变色狙击 变色闪光 变身 变速推镜 变速推镜II 变黑白 可爱圣诞 可爱女生 可爱涂鸦 可爱猪 可爱龙龙 吓到失魂 吸血鬼 吻痕坏笑 告白氛围 咔嚓 哈哈哈 哈哈弹幕 哈哈镜 哈苏胶片 哥特 唱片 唱片封面 啊啊啊啊 嘻哈眼镜 噪点 噪点屏闪 噪片映射 四屏 回弹摇摆 回忆文件夹 回忆胶片 图腾 圆形分屏 圆形烟花 圆形监控 圆形虚线放大镜 圣诞CD 圣诞Kira 圣诞光斑 圣诞小熊 圣诞帽 圣诞日记 圣诞明信片 圣诞星光 圣诞树 圣诞胡子 圣诞辣妹 圣诞边框 圣诞铃铛 圣诞限定 地狱使者 基础黑框 塑料封面 塑料封面 II 塑料封面III 声波 复古DV 复古DV II 复古DV III 复古DV IV 复古半调 复古发光 复古多格 复古弹窗 I 复古弹窗 II 复古彩虹 复古拼贴 复古撕纸 复古漫画 复古甜心 复古电视 复古电视机 复古碎钻 复古紫调 复古红调 复古蓝调 复古辉光 复古边框 复古连拍 复古闪闪 复古频闪 夏日冰块 夏日泡泡 I 夕阳 夕阳 II 夕阳 III 多屏圣诞树 夜蝶 夜视框 大头 大字祝福 大爆竹 大眼睛 大雪 大雪纷飞 天使 天使光 天使环 天使翅膀 天使降临 太阳神 失焦 失焦CCD 失焦光斑 夸夸弹幕 夸张信号 夺冠 奇行种 好吃 妖气 委屈丑丑脸 孔明灯 孔明灯 II 字幕投影 字幕投影 II 字幕投影 III 字幕投影 IV 定格祝福 定格闪烁 实况开幕 害羞 密码解锁 对焦DV 小剧场 小动物 小恶魔 小花花 小鹿角 少女心 少女心事 少女星闪 尴尬住了 局部扭曲 局部推镜 局部模糊 局部色彩 局部马赛克 居中闪切 屏幕律动 左右摇晃 巴哥犬 布拉格 帅气男生 幻动光斑 幻彩故障 幻彩文字 幻彩流光 幻影 幻影 I 幻影 II 幻影平移 幻术摇摆 幻觉 幻觉 II 幽灵 广告运镜 广角 庆祝彩带 开幕 开幕 II 弥散流光 弯曲故障 弹动摇镜 弹动旋入 弹性闪动 弹震运镜 强锐化 录像带 录像带 II 录像带 III 录制框 录制边框 录制边框 II 录制边框 III 录制边框 IIII 彩信 彩光幻影 彩光摇晃 彩光频闪 彩噪画质 彩带 彩带飘落 彩色像素 彩色描边 彩色流光 I 彩色流光 II 彩色流光 III 彩色漫画 彩色火焰 彩色珠滴 彩色电光 彩色碎彩 彩色碎片 彩色碎片 II 彩色碎闪 彩色负片 彩色重影 彩色闪烁 彩色雪花 彩虹光 彩虹光 II 彩虹光影 彩虹光晕 彩虹射线 彩虹幻影 彩虹棱镜 彩虹气泡 彩虹泛光 彩虹流体 彩虹爱心 彩虹边缘 彩虹闪屏 彩边频闪 彩钻 影分身 微信祝福 微笑摇摆头 微震闪黑 心动 心动信号 心心眼 心河 心花怒放 心花怒放III 心跳 心跳 II 心跳黑框 必杀技 必杀技 II 快速变焦 快闪运镜 怀旧画质 怀旧边框 怀旧边框 II 怦然心动 恐怖故事 恐怖故事 II 恐怖故事 III 恐怖涂鸦 恐怖综艺 恭喜发财 恭喜发财 II 恶灵冲屏 恶灵骑士 恶魔之翼 恶魔印记 恶魔尾巴 恶魔角 情绪定格 惨 意识流 愛 慢门拖影 憔悴 懵 我不听 我太可爱了 我服了 我爱了 我酸了 我麻了 手写描边 手写边框 手印涂抹 手帐边框 手持运镜 手电筒 手绘拍摄器 手绘描边 手绘边框 II 打击 打脸 扫描 II 扫描光条 扭动变焦 扭曲变焦 扭曲模糊 抖动 抖动模糊 折叠拜年 折痕 折痕 II 折痕 III 折痕 IV 折痕 V 报纸:今日热门 抽帧拖影 拉伸旋镜 拉扯震动 拉镜开幕 拍照定格 拍立得成像 拖影灯光 拟截图放大镜 拼贴抽帧 拼贴风暴 拽酷红眼 捕梦 掉小珍珠啦 推拉跟随 推拉运镜 推近推远 摇摆 摇摆 II 摇摇乐 摇晃叠影 摇晃推镜 摇晃运镜 撒星星 撒星星 II 撕纸定格 撕纸拼贴 撕纸涂鸦边框 撕纸特写 播放器 播放器 II 播放界面 擦拭开幕 放大镜 放大镜视角 放映机 放映机卡顿 放映机抖动 放映滚动 故障 故障 II 故障定格 故障开幕 故障描边 I 故障读条 故障震闪 散光弹动 散光闪烁 数字矩阵 数学公式 敲打 文字闪动 斑斓 斜向模糊 斜线震动 新年仙女棒 新年倒数 新年兔气球 新年开幕 新年快乐 新年投影 新年星黛露 新年烟花 II 新年的一封信 新年礼花 新年边框 新春唱片 新春杂志 新春海报 新春祝福 新春边框 方形取景器 方形开幕 方形模糊 旋焦 旋焦推镜 旋转分身 旋转变焦 旋转回弹 旋转圆球 旋转抖动 旋转抖动 II 旋转方块 无信号 无限穿越 日式DV 日文字幕 日系大头贴 日落灯 日进斗金 时光碎片 时尚涂鸦 时间停止 星光 星光 II 星光变焦 星光放射 星光绽放 星光闪耀 星光闪闪 星夜 星星冲屏 星星变焦 星星坠落 星星彩绘 星星投影 星星拖尾 星星灯 星星闪烁 星星闪烁 II 星星闪烁 III 星月童话 星河 星河 II 星火 星火 II 星火炸开 星移 星空 星辰 星辰 I 星辰 II 星辰 III 星雨 春日樱花 春日边框 晴天光线 暗夜 暗夜归来 暗夜彩虹 暗夜彩虹 II 暗夜彩虹III 暗夜精灵 暗夜蝙蝠 暗角 暗黑剪影 暗黑噪点 暗黑蝙蝠 曝光 曝光变焦 曝光扩散 曝光降低 曲线模糊 月亮投影 月亮闪闪 月光闪闪 有事吗？ 望远镜 未来主义 未来眼镜 机械几何 机械姬 I 机械姬 II 机械环绕 I 机械环绕 II 机灵怪 杂志 极速旋转 柔和辉光 树影 树影 II 格纹纸质 格纹纸质 II 梦境 梦境 II 梦境 III 梦境 IV 梦幻辉光 梦幻雪花 梦蝶 梦魇 梵高背景 模拟拍照 模糊 模糊开幕 模糊星光 模糊星光 II 模糊闭幕 横向闪光 横向闭幕 横条开幕 横纹故障 横纹故障 II 樱花朵朵 樱花飘落 橘色负片 欧根纱 欧根纱II 欧美女性 欧美男性 毛刺 毛玻璃 气泡 I 气泡 II 气波 气炸了 气球满屏 气球花花 氛围大头贴 氛围边框 水光影 水墨晕染 水彩晕染 水波倒影 水波模糊 水波泛起 水波流动 水波纹 水波纹投影 水波负片 水滴扩散 水滴模糊 水滴滚动 水雾消散 沉沦 油画模糊 油画泼墨 油画纹理 油纸伞 法式暖调 法式涂鸦 泛光扫描 泛光爆闪 泛光闪动 泡泡 泡泡光斑 泡泡冲屏 泡泡变焦 波动清晰 波浪 波浪丝印 波点分身 波点彩绘 波纹扭曲 波纹色差 波纹闪动 流体冲屏 流体故障 流体荡开 流光描边 流光碎闪 流动烟雾 流口水 流星雨 浓雾 浪漫氛围 浪漫氛围 II 浪漫烟火 海报描边 海鸥DC 涂鸦vlog 涂鸦切割边框 涂鸦切开 涂鸦抽帧 涂鸦拍立得 涂鸦鬼影 液态分离 淡彩边框 清新绿格子 渐显开幕 渐渐放大 渐隐闭幕 温柔细闪 游戏界面 滑动打开 滑动载入 满屏问号 漂浮爱心 漏光噪点 漏光闪烁 漩涡 漩涡溶解 漫画负片 潮流入侵 潮流涂鸦 潮酷女孩 潮酷男孩 激光几何 瀑布开幕 瀑布烟花 火光 火光刷过 火光包围 火光翻滚 火光蔓延 火焰图腾 火焰拖尾 火焰环绕 火焰翅膀 I 火焰翅膀 II 灵异幻觉 灵机一动 灵魂出窍 灵魂出窍 II 灵魂出走 灿灿金币 灿金彩带 炫光变焦 炫光扫描 炫彩 炫彩 II 炸蛇烟花 点赞 烟火星河 烟花 烟花 II 烟花 III 烟花2024 烟花2025 烟花光晕 烟花孔明灯 烟花字 烟雾 烟雾炸开 热力光谱 I 热力光谱 II 热恋 焰火 熬夜冠军 爆元宝 爆炸 爆闪锐化 爱心 爱心bling 爱心Kira 爱心下雪 爱心光斑 爱心光斑 II 爱心光波 爱心发射 爱心啵啵 爱心射线 爱心扫光 爱心投影 爱心方块 爱心暗角 爱心气泡 爱心气球 爱心泡泡 爱心烟花Ⅱ 爱心焰火 爱心爆炸 爱心眼 爱心缤纷 爱心缤纷 II 爱心美瞳 爱心跳动 爱心跳动 II 爱心软糖 爱心边框 爱心闪烁 牛皮纸关闭 牛皮纸打开 牛皮纸边框 I 牛皮纸边框 II 狱火 狼人 猩猩脸 猫眼迎财 猫耳女孩 玫瑰冲屏 玫瑰花瓣 玻璃破碎 珠光Kira 珠光碎闪 琉璃拖影 甜心投影 生日快乐 生气 电光包围 电光描边 电光描边 II 电光放射 电光波动 电光漩涡 电光灼烧 电光爆闪 电光爆闪 II 电光爱心 电光眼 电光耳机 电击 电子复古粉 电子屏 电子屏故障 电影刮花 电影感 电影感画幅 电脑桌面 电视关机 电视开机 电视彩虹屏 电视纹理 电音故障 画展边框 画质清晰 白噪点边框 白胶边框 白色描边 白色渐显 白色爱心 白色线框 白色边框 白鸽 百叶窗 百叶窗 II 监控 盗梦空间 盛世美颜 相机抓拍 相机框抖动 相机网格 相片定格 相纸 真爱至上 真的会谢 真香 眼神光 瞬移 瞬间模糊 矩形闪白 矩阵频闪 破冰 破碎的心 碎片分身 碎闪描边 碎闪边缘 磁带DV 磨砂水晶 磨砂纹理 祝福环绕 神明少女 神龙纳福 福气满满 秋日暖阳 秋日暖黄 科技氛围 I 科技氛围 II 科技氛围 III 秘密 移形回位 移形幻影 I 移形幻影 II 移轴模糊 空气流体 空灵 窗格 窗格光 竖向开幕 竖向闪光 竖线屏闪 竖闪模糊 童趣闪电 笑哭 简约边框 箭头放大镜 箭头环绕 粉红老电视 粉红芭比边框 粉色便便 粉色闪粉 粉雪 粉黄渐变 粒子弥散 粒子放射 精灵闪粉 精细锐化 精致辉光 糖果纸 紫光夜 紫色波纹 紫色负片 紫雾 繁星点点 繁花棱镜II 红包来了 红包转转 红晕 红蓝魔 红边模糊 纵向开幕 纵向模糊 纵向跳动 纸膜边框 I 纸膜边框 II 纸质抽帧 纸质撕边 纸质边框 纸质边框 II 纸醉金迷 线光变速 细闪 细闪 II 细闪 III 绚丽光斑 缤纷 缤纷彩带 缤纷烟花 缩放运镜 网点丝印 美味召唤 美式 美式 II 美式 III 美式 IV 美式 V 美漫 群蝶飞舞 羽毛 羽毛飘落 翻转变焦 翻转开幕 老式DV 老照片 老照片 II 老照片 III 老电影 老电影 II 老电视卡顿 聚光灯 聚光灯金粉 聚焦 聚焦色散 背景拖影 背景氛围II 胡言乱语 胶卷 胶片 胶片 II 胶片 III 胶片 IV 胶片V 胶片冷绿 胶片抖动 胶片显影 胶片暖棕 胶片框 胶片框 II 胶片框 III 胶片滚动 胶片漏光 胶片漏光 II 胶片漏光III 胶片翻转 胶片边框 胶片连拍 胶片闪切 脉搏跳动 脸红 脸绿了 脸部故障 腾云驾雾 自然 自然 II 自然 III 自然 IV 自然 V 舞者 舞者 II 色差 色差开幕 色差放大 色差放射 色差故障 色差故障 II 色差星闪 色差震闪 色差默片 色散冲击 色散故障 节奏热成像 节日彩带 花屏故障 花屏故障 II 花火 花火 II 花瓣环绕 花瓣飘落 花瓣飞扬 荡漾 II 荡秋千 荧光扫描 荧光星河 荧光爱心 荧光线描 荧光绿 荧光蝙蝠 荧幕噪点 荧幕噪点 II 菱形光斑 菱形变焦 萤光 萤光飞舞 萤火 落叶 落叶 II 落樱 蒸汽波 蒸汽波投影 蒸汽波路灯 蒸汽腾腾 蓝光扫描 蓝光爆闪 蓝线模糊 蓝色丝印 蓝色负片 蓝色闪电边框 蔡国强烟花 虚化 虚拟人生 I 虚拟人生 II 虹光旋入 蛇形走位 蛇蛇涂鸦 蝙蝠Kira 蝴蝶 蝴蝶 II 蝴蝶光斑 蝴蝶翅膀 蝶舞 表面模糊 衰 裂开了 西海岸涂鸦 视线遮挡 视频分割 视频播放 视频界面 记忆存档 诡异分割 诡异故障 负片分屏 负片描边 负片涂鸦 负片涂鸦 II 负片涂鸦 III 负片游移 负片闪烁 负片频闪 负片频闪 II 财富满满 财富满满 II 贴身粒子 赛博朋克 I 赛博朋克 II 赛博眼镜 赞赞赞 超大光斑 超强锐化 跟随运镜 跟随运镜 II 跳色四宫格 蹦迪光 蹦迪彩光 车窗 车窗 II 车窗影 转运祝福 轮廓扫描 轻微抖动 轻微放大 轻微故障 轻金属 辉光开幕 边缘glitch 边缘加色 边缘加色 II 边缘加色 III 边缘发光 边缘扫光 边缘荧光 迎接2025 运动一夏 运动轨迹 迪斯科 迷幻分身 迷幻故障 迷幻烟雾 迷幻荡漾 迷幻震动 迷离 迷茫 迷雾 逆光对焦 选中框 邮票边框 重复变焦 重复震闪 金元宝 金属背景 金币掉落 金片 金片 II 金片炸开 金粉 金粉 II 金粉 III 金粉撒落 金粉旋转 金粉聚拢 金粉闪闪 金粉飘落 金色碎片 金色辉光 金色雪花 金蛇贺岁 金边闪烁 金银珠宝 金鱼漂浮 钻光 钻石碎片 铅笔涂鸦 银杏飘落 银蛇缠绕 镜像 镜头变焦 镭射眼 I 镭射眼 II 镭射边框 长虹玻璃 闪亮登场 闪亮登场 II 闪光弹跳 闪光放大 闪光灯 II 闪光灯 Ⅰ 闪光灯IV 闪光震动 闪动 闪动光斑 闪屏 闪影 闪烁 闪电 闪电扭曲 闪电炸裂 闪电环绕 闪电眼 闪白 闪白 II 闪粉胶片 闪耀星光 闪闪 闪闪发光 II 闪黑 闪黑II 闭幕 闭幕 II 阳光 阴云密布 阴暗面 随机色块 随机色块 II 随机裁剪 随机闪切 随机马赛克 隐形人 隔行DV 隔行扫描 难吃 难过 雨季 I 雨滴 雨滴2 雨滴晕开 雪窗 雪花 雪花光斑 雪花冲屏 雪花变色 雪花开幕 雪花故障 雪花散落 雪花眼泪 雪花细闪 雪雾 零帧起手 零点解锁 雾气 雾气 II 雾气光线 雾镜 II 震动 震动光束 震动发光 震动屏闪 震动扫光 震动推镜 震闪渐黑 霓虹光线 霓虹投影 霓虹摇摆 霓虹灯 霓虹爱心 霓虹特技 霓虹闪切 音符拖尾 音符拖尾 II 预警 颤抖 飓风 飘落花瓣 飘落闪粉 飘落闪粉 II 飘雪 飘雪 II 飞机窗 飞翔的帽子 飞速计算 马赛克 马赛克闪切 高光人物 高光瞬间 高速彩光 鬼火 魅力光束 魔法 魔法变身 魔法边框 魔法边框 II 鱼眼 鱼眼 II 鱼眼 III 鱼眼 IV 鱼眼星星 鱼眼涂鸦 鱼眼闪电 黄蓝星芒 黑人女孩 黑人男生 黑白VHS 黑白三格 黑白漫画 黑白漫画 II 黑白线描 黑白胶片 黑线故障 黑羽毛 黑羽毛 II 黑胶边框 黑色噪点 黑色眼泪 黑色老电视 鼻血 ``` ## 响应格式 ### 成功响应 (200) ```json { "code": 0, "message": "success", "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258", "track_id": "effect_track_123", "effect_ids": ["effect_001", "effect_002"], "segment_ids": ["seg_001", "seg_002"] } ``` ### 响应字段说明 | 字段名 | 类型 | 说明 | |--------|------|------| | draft_url | string | 更新后的草稿URL | | track_id | string | 特效轨道ID | | effect_ids | array | 添加的特效ID列表 | | segment_ids | array | 创建的特效片段ID列表 | ### 错误响应 ```json { "code": 2020, "message": "无效的特效信息，请检查effect_infos字段值是否正确" } ``` ## 使用示例 ### cURL 示例 #### 1. 基本特效添加 ```bash curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/add_effects \ -H "Content-Type: application/json" \ -d '{ "draft_url": "YOUR_DRAFT_URL", "effect_infos": "[{\"effect_title\": \"录制边框 III\", \"start\": 0, \"end\": 5000000}]" }' ``` #### 2. 批量特效添加 ```bash curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/add_effects \ -H "Content-Type: application/json" \ -d '{ "draft_url": "YOUR_DRAFT_URL", "effect_infos": "[{\"effect_title\": \"录制边框 III\", \"start\": 0, \"end\": 5000000}, {\"effect_title\": \"简约边框\", \"start\": 2000000, \"end\": 7000000}]" }' ``` ## 错误码说明 | 错误码 | 错误信息 | 说明 | 解决方案 | |--------|----------|------|----------| | 1001 | 参数校验失败 | 请求体未通过字段校验 | 检查参数类型与必填字段 | | 2001 | 无效的草稿URL | `draft_url` 缺失、格式错误，或草稿不在缓存中 | 传入 `create_draft` 返回的 `draft_url` | | 2020 | 无效的特效信息 | `effect_infos` 不是合法 JSON、某项缺少 `effect_title`/`start`/`end`、`end` 不大于 `start`，或特效名称为空 | 修正 JSON 字符串与必填字段 | | 2021 | 特效添加失败 | 写入草稿过程出错 | 检查草稿状态后重试 | | 2022 | 特效未找到 | `effect_title` 与任何支持的特效名称都不匹配 | 使用上方「支持的特效名称」列表中的名称 | | 2042 | 草稿锁获取超时 | 同一时间只允许一个操作，草稿正被占用 | 稍后重试 | ## 注意事项 1. **时间单位**: 所有时间参数使用微秒（1秒 = 1,000,000微秒） 2. **特效名称**: 确保使用有效的特效名称 3. **时间范围**: end必须大于start 4. **轨道管理**: 系统自动创建特效轨道 5. **性能考虑**: 避免同时添加大量特效 ## 工作流程 1. 验证必填参数（draft_url, effect_infos） 2. 检查时间范围的有效性 3. 从缓存中获取草稿 4. 创建特效轨道 5. 解析特效信息并创建特效片段 6. 添加片段到轨道 7. 保存草稿 8. 返回特效信息 ## 相关接口 - [创建草稿](./create_draft.md) - [添加视频](./add_videos.md) - [添加音频](./add_audios.md) - [添加图片](./add_images.md) - [保存草稿](./save_draft.md) - [生成视频](./gen_video.md) ---
📚 **项目资源** **GitHub**: [https://github.com/Hommy-master/capcut-mate](https://github.com/Hommy-master/capcut-mate) **Gitee**: [https://gitee.com/taohongmin-gitee/capcut-mate](https://gitee.com/taohongmin-gitee/capcut-mate)