mirror of
https://github.com/Hommy-master/capcut-mate.git
synced 2026-08-28 15:12:08 +08:00
更新文档。
This commit is contained in:
Hommy
+885
-4
@@ -52,13 +52,13 @@ Add images to existing drafts. This interface is used to add image materials to
|
||||
| end | number | ✅ | - | Image end display time (microseconds) |
|
||||
| width | number | ❌ | Draft canvas width | Image width in pixels (optional); segment size follows the image file |
|
||||
| height | number | ❌ | Draft canvas height | Image height in pixels (optional); segment size follows the image file |
|
||||
| in_animation | string | ❌ | - | Intro animation name (optional) |
|
||||
| out_animation | string | ❌ | - | Outro animation name (optional) |
|
||||
| loop_animation | string | ❌ | - | Loop animation name (optional) |
|
||||
| in_animation | string | ❌ | - | Intro animation name from Intro animations below |
|
||||
| out_animation | string | ❌ | - | Outro animation name from Outro animations below |
|
||||
| loop_animation | string | ❌ | - | Loop animation name from Loop animations below |
|
||||
| in_animation_duration | number | ❌ | - | Intro animation duration in μs (optional) |
|
||||
| out_animation_duration | number | ❌ | - | Outro animation duration in μs (optional) |
|
||||
| loop_animation_duration | number | ❌ | - | Single loop duration in μs (optional) |
|
||||
| transition | string | ❌ | - | Transition effect name (optional) |
|
||||
| transition | string | ❌ | - | Transition name from Transitions below |
|
||||
| transition_duration | number | ❌ | 500000 | Transition duration in μs (optional), range 100000–2500000 |
|
||||
|
||||
### Parameter Details
|
||||
@@ -110,6 +110,887 @@ Add images to existing drafts. This interface is used to add image materials to
|
||||
- If provided, must be integers greater than 0
|
||||
- On-screen size is mainly determined by the **image file** and `scale_x` / `scale_y`, not these fields
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### Supported Transitions and Animations
|
||||
|
||||
Use the names below directly as `image_infos` field values (same as CapCut/Jianying display names). Unmatched names are ignored.
|
||||
|
||||
#### Transitions (transition, 453 total)
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
|
||||
#### Intro animations (in_animation, 155 total)
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
上下抖动
|
||||
九宫格
|
||||
交叉震动
|
||||
交错开幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
动感放大
|
||||
动感缩小
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转入
|
||||
向上转入 II
|
||||
向上闪入
|
||||
向下滑动
|
||||
向下甩入
|
||||
向下甩动
|
||||
向右上甩入
|
||||
向右下甩入
|
||||
向右滑动
|
||||
向右甩入
|
||||
向右转入
|
||||
向左上甩入
|
||||
向左下甩入
|
||||
向左滑动
|
||||
向左转入
|
||||
四屏转换
|
||||
圆形开幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
展开
|
||||
左右抖动
|
||||
幸运圣诞树
|
||||
开辟2025
|
||||
弹力分割
|
||||
弹近
|
||||
录像带分屏
|
||||
心形放大
|
||||
快速翻页
|
||||
手写云朵
|
||||
手机倒数
|
||||
扫描
|
||||
抖动下降
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠开幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑入
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转开幕
|
||||
时间倒计时
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
果冻 I
|
||||
果冻 II
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐显
|
||||
游蛇开幕
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
点开
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃聚集
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
神奇弹窗
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方分体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻书
|
||||
翻入
|
||||
翻卡
|
||||
老电视
|
||||
聚合
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转开幕
|
||||
转圈圈
|
||||
轻微抖动
|
||||
轻微抖动 II
|
||||
轻微抖动 III
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钟摆
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面组成
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雨刷
|
||||
雨刷 II
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震撼倒数
|
||||
震波
|
||||
震波 II
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飞近
|
||||
马赛克
|
||||
魔方 III
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### Outro animations (out_animation, 124 total)
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
九宫格
|
||||
交叉震动
|
||||
交错闭幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转出
|
||||
向上转出 II
|
||||
向上闪出
|
||||
向下滑动
|
||||
向下甩动
|
||||
向右滑动
|
||||
向左滑动
|
||||
四屏转换
|
||||
圆形闭幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
幕布
|
||||
幸运圣诞树
|
||||
弹力分割
|
||||
弹远
|
||||
录像带分屏
|
||||
心形缩小
|
||||
快速翻页
|
||||
手写云朵
|
||||
扫描
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠
|
||||
折叠闭幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑出
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转闭幕
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐隐
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃爆开
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方合体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻出
|
||||
翻卡
|
||||
老电视
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转闭幕
|
||||
转圈圈
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面拆分
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飘散
|
||||
飞远
|
||||
马赛克
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### Loop animations (loop_animation, 123 total)
|
||||
|
||||
```text
|
||||
三分割
|
||||
三分割 II
|
||||
上下分割
|
||||
上下分割 II
|
||||
上升旋转
|
||||
下降向右
|
||||
下降向左
|
||||
中间分割
|
||||
中间分割 II
|
||||
分身
|
||||
分身 II
|
||||
动感摇晃I
|
||||
动感摇晃II
|
||||
叠叠乐
|
||||
叠叠乐 II
|
||||
叠叠乐 III
|
||||
叠叠乐 IV
|
||||
叠叠乐 V
|
||||
叠叠乐 Ⅵ
|
||||
右拉镜
|
||||
向右下降
|
||||
向右缩小
|
||||
向左下降
|
||||
向左缩小
|
||||
哈哈镜
|
||||
哈哈镜 II
|
||||
四格滑动
|
||||
四格滑动 II
|
||||
四格翻转
|
||||
四格翻转 II
|
||||
四格转动
|
||||
四格转动 II
|
||||
回弹伸缩
|
||||
回忆旋转
|
||||
坠落
|
||||
夹心饼干
|
||||
夹心饼干 II
|
||||
小火车
|
||||
小火车 II
|
||||
小火车 III
|
||||
小火车 IV
|
||||
小陀螺
|
||||
小陀螺 II
|
||||
左右分割
|
||||
左右分割 II
|
||||
左拉镜
|
||||
弹入旋转
|
||||
弹动冲屏
|
||||
形变右缩
|
||||
形变左缩
|
||||
形变缩小
|
||||
悠悠球
|
||||
悠悠球 II
|
||||
手机
|
||||
手机 II
|
||||
手机 III
|
||||
扭曲拉伸
|
||||
抖入放大
|
||||
拉伸扭曲
|
||||
放大弹动
|
||||
斜转
|
||||
斜转 II
|
||||
方片转动
|
||||
方片转动 II
|
||||
旋入晃动
|
||||
旋出渐隐
|
||||
旋转上升
|
||||
旋转伸缩
|
||||
旋转回吸
|
||||
旋转缩小
|
||||
旋转降落
|
||||
晃动旋出
|
||||
水晶
|
||||
水晶 II
|
||||
波动吸收
|
||||
波动放大
|
||||
波动滑出
|
||||
海盗船
|
||||
海盗船 II
|
||||
海盗船 III
|
||||
海盗船 IV
|
||||
滑入波动
|
||||
滑滑梯
|
||||
滑滑梯 II
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相框滑动
|
||||
碎块滑动
|
||||
碎块滑动 II
|
||||
立方体
|
||||
立方体 II
|
||||
立方体 III
|
||||
立方体 IV
|
||||
立方体 V
|
||||
红酒摇晃
|
||||
绕圈圈
|
||||
绕圈圈 II
|
||||
绕圈圈 III
|
||||
绕圈圈 IV
|
||||
缩小弹动
|
||||
缩小旋转
|
||||
缩小转出
|
||||
缩放
|
||||
缩放 II
|
||||
翻转
|
||||
翻转 II
|
||||
翻转 III
|
||||
翻转 IV
|
||||
翻转 V
|
||||
翻转 VI
|
||||
荡秋千
|
||||
荡秋千 II
|
||||
跳跳糖
|
||||
转入转出
|
||||
转入转出 II
|
||||
转圈圈
|
||||
过山车
|
||||
过山车 II
|
||||
闪光放大
|
||||
闪光放大 II
|
||||
降落旋转
|
||||
魔方
|
||||
魔方 II
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
|
||||
## Response Format
|
||||
|
||||
### Success Response (200)
|
||||
|
||||
+885
-4
@@ -52,13 +52,13 @@ POST /openapi/capcut-mate/v1/add_images
|
||||
| end | number | ✅ | - | 图片结束显示时间(微秒) |
|
||||
| width | number | ❌ | 草稿画布宽度 | 图片宽度(像素)，可选；未传时不校验，片段尺寸以图片文件为准 |
|
||||
| height | number | ❌ | 草稿画布高度 | 图片高度(像素)，可选；未传时不校验，片段尺寸以图片文件为准 |
|
||||
| in_animation | string | ❌ | - | 入场动画名称（可选） |
|
||||
| out_animation | string | ❌ | - | 出场动画名称（可选） |
|
||||
| loop_animation | string | ❌ | - | 循环动画名称（可选） |
|
||||
| in_animation | string | ❌ | - | 入场动画名称，须为下方「入场动画」列表中的值 |
|
||||
| out_animation | string | ❌ | - | 出场动画名称，须为下方「出场动画」列表中的值 |
|
||||
| loop_animation | string | ❌ | - | 循环动画名称，须为下方「循环动画」列表中的值 |
|
||||
| in_animation_duration | number | ❌ | - | 入场动画时长(微秒，可选) |
|
||||
| out_animation_duration | number | ❌ | - | 出场动画时长(微秒，可选) |
|
||||
| loop_animation_duration | number | ❌ | - | 循环动画单次时长(微秒，可选) |
|
||||
| transition | string | ❌ | - | 转场效果名称（可选） |
|
||||
| transition | string | ❌ | - | 转场名称，须为下方「转场」列表中的值 |
|
||||
| transition_duration | number | ❌ | 500000 | 转场时长(微秒，可选)，范围 100000～2500000 |
|
||||
|
||||
### 参数详解
|
||||
@@ -110,6 +110,887 @@ POST /openapi/capcut-mate/v1/add_images
|
||||
- 若显式传入，须为大于 0 的整数
|
||||
- 片段在剪映中的显示尺寸主要由**图片文件本身**及 `scale_x` / `scale_y` 控制，与这两项无强绑定
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### 支持的转场与动画名称
|
||||
|
||||
下列名称可直接作为 `image_infos` 中对应字段的值（与剪映端展示名一致）。未匹配到时该效果不会生效。
|
||||
|
||||
#### 转场（transition，共 453 种）
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
|
||||
#### 入场动画（in_animation，共 155 种）
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
上下抖动
|
||||
九宫格
|
||||
交叉震动
|
||||
交错开幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
动感放大
|
||||
动感缩小
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转入
|
||||
向上转入 II
|
||||
向上闪入
|
||||
向下滑动
|
||||
向下甩入
|
||||
向下甩动
|
||||
向右上甩入
|
||||
向右下甩入
|
||||
向右滑动
|
||||
向右甩入
|
||||
向右转入
|
||||
向左上甩入
|
||||
向左下甩入
|
||||
向左滑动
|
||||
向左转入
|
||||
四屏转换
|
||||
圆形开幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
展开
|
||||
左右抖动
|
||||
幸运圣诞树
|
||||
开辟2025
|
||||
弹力分割
|
||||
弹近
|
||||
录像带分屏
|
||||
心形放大
|
||||
快速翻页
|
||||
手写云朵
|
||||
手机倒数
|
||||
扫描
|
||||
抖动下降
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠开幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑入
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转开幕
|
||||
时间倒计时
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
果冻 I
|
||||
果冻 II
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐显
|
||||
游蛇开幕
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
点开
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃聚集
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
神奇弹窗
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方分体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻书
|
||||
翻入
|
||||
翻卡
|
||||
老电视
|
||||
聚合
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转开幕
|
||||
转圈圈
|
||||
轻微抖动
|
||||
轻微抖动 II
|
||||
轻微抖动 III
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钟摆
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面组成
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雨刷
|
||||
雨刷 II
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震撼倒数
|
||||
震波
|
||||
震波 II
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飞近
|
||||
马赛克
|
||||
魔方 III
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### 出场动画（out_animation，共 124 种）
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
九宫格
|
||||
交叉震动
|
||||
交错闭幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转出
|
||||
向上转出 II
|
||||
向上闪出
|
||||
向下滑动
|
||||
向下甩动
|
||||
向右滑动
|
||||
向左滑动
|
||||
四屏转换
|
||||
圆形闭幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
幕布
|
||||
幸运圣诞树
|
||||
弹力分割
|
||||
弹远
|
||||
录像带分屏
|
||||
心形缩小
|
||||
快速翻页
|
||||
手写云朵
|
||||
扫描
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠
|
||||
折叠闭幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑出
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转闭幕
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐隐
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃爆开
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方合体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻出
|
||||
翻卡
|
||||
老电视
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转闭幕
|
||||
转圈圈
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面拆分
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飘散
|
||||
飞远
|
||||
马赛克
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### 循环动画（loop_animation，共 123 种）
|
||||
|
||||
```text
|
||||
三分割
|
||||
三分割 II
|
||||
上下分割
|
||||
上下分割 II
|
||||
上升旋转
|
||||
下降向右
|
||||
下降向左
|
||||
中间分割
|
||||
中间分割 II
|
||||
分身
|
||||
分身 II
|
||||
动感摇晃I
|
||||
动感摇晃II
|
||||
叠叠乐
|
||||
叠叠乐 II
|
||||
叠叠乐 III
|
||||
叠叠乐 IV
|
||||
叠叠乐 V
|
||||
叠叠乐 Ⅵ
|
||||
右拉镜
|
||||
向右下降
|
||||
向右缩小
|
||||
向左下降
|
||||
向左缩小
|
||||
哈哈镜
|
||||
哈哈镜 II
|
||||
四格滑动
|
||||
四格滑动 II
|
||||
四格翻转
|
||||
四格翻转 II
|
||||
四格转动
|
||||
四格转动 II
|
||||
回弹伸缩
|
||||
回忆旋转
|
||||
坠落
|
||||
夹心饼干
|
||||
夹心饼干 II
|
||||
小火车
|
||||
小火车 II
|
||||
小火车 III
|
||||
小火车 IV
|
||||
小陀螺
|
||||
小陀螺 II
|
||||
左右分割
|
||||
左右分割 II
|
||||
左拉镜
|
||||
弹入旋转
|
||||
弹动冲屏
|
||||
形变右缩
|
||||
形变左缩
|
||||
形变缩小
|
||||
悠悠球
|
||||
悠悠球 II
|
||||
手机
|
||||
手机 II
|
||||
手机 III
|
||||
扭曲拉伸
|
||||
抖入放大
|
||||
拉伸扭曲
|
||||
放大弹动
|
||||
斜转
|
||||
斜转 II
|
||||
方片转动
|
||||
方片转动 II
|
||||
旋入晃动
|
||||
旋出渐隐
|
||||
旋转上升
|
||||
旋转伸缩
|
||||
旋转回吸
|
||||
旋转缩小
|
||||
旋转降落
|
||||
晃动旋出
|
||||
水晶
|
||||
水晶 II
|
||||
波动吸收
|
||||
波动放大
|
||||
波动滑出
|
||||
海盗船
|
||||
海盗船 II
|
||||
海盗船 III
|
||||
海盗船 IV
|
||||
滑入波动
|
||||
滑滑梯
|
||||
滑滑梯 II
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相框滑动
|
||||
碎块滑动
|
||||
碎块滑动 II
|
||||
立方体
|
||||
立方体 II
|
||||
立方体 III
|
||||
立方体 IV
|
||||
立方体 V
|
||||
红酒摇晃
|
||||
绕圈圈
|
||||
绕圈圈 II
|
||||
绕圈圈 III
|
||||
绕圈圈 IV
|
||||
缩小弹动
|
||||
缩小旋转
|
||||
缩小转出
|
||||
缩放
|
||||
缩放 II
|
||||
翻转
|
||||
翻转 II
|
||||
翻转 III
|
||||
翻转 IV
|
||||
翻转 V
|
||||
翻转 VI
|
||||
荡秋千
|
||||
荡秋千 II
|
||||
跳跳糖
|
||||
转入转出
|
||||
转入转出 II
|
||||
转圈圈
|
||||
过山车
|
||||
过山车 II
|
||||
闪光放大
|
||||
闪光放大 II
|
||||
降落旋转
|
||||
魔方
|
||||
魔方 II
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
|
||||
## 响应格式
|
||||
|
||||
### 成功响应 (200)
|
||||
|
||||
+467
-3
@@ -22,7 +22,7 @@ Batch add video materials to existing drafts. This interface is a powerful video
|
||||
```json
|
||||
{
|
||||
"draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258",
|
||||
"video_infos": "[{\"video_url\":\"https://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":5000000,\"mask\":\"circle\",\"transition\":\"fade\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"video_infos": "[{\"video_url\":\"https://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":5000000,\"mask\":\"circle\",\"transition\":\"叠化\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"scene_timelines": [{"start":0,"end":2500000}],
|
||||
"alpha": 0.5,
|
||||
"scale_x": 1.0,
|
||||
@@ -56,7 +56,7 @@ Batch add video materials to existing drafts. This interface is a powerful video
|
||||
| end | number | ✅ | - | Video end playback time (microseconds) |
|
||||
| duration | number | ❌ | end-start | Total video duration (microseconds) |
|
||||
| mask | string | ❌ | - | Mask type |
|
||||
| transition | string | ❌ | - | Transition effect name |
|
||||
| transition | string | ❌ | - | Transition name from Supported Transition Names below |
|
||||
| transition_duration | number | ❌ | 500000 | Transition duration (microseconds) |
|
||||
| volume | number | ❌ | 1.0 | Volume size (0-1) |
|
||||
|
||||
@@ -141,6 +141,470 @@ Supported mask types (all optional, default is no mask):
|
||||
// Result: Video plays at 2x speed, actual playback duration is 1 second
|
||||
```
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### Supported Transition Names (`transition` values)
|
||||
|
||||
Use the names below directly as `video_infos.transition` (same as CapCut/Jianying display names). Unmatched names are ignored.
|
||||
|
||||
Total: **453** transitions:
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
|
||||
## Response Format
|
||||
|
||||
### Success Response (200)
|
||||
@@ -197,7 +661,7 @@ 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://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":10000000,\"mask\":\"circle\",\"transition\":\"fade\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"video_infos": "[{\"video_url\":\"https://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":10000000,\"mask\":\"circle\",\"transition\":\"叠化\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"alpha": 1.0,
|
||||
"scale_x": 1.2,
|
||||
"scale_y": 1.2
|
||||
|
||||
+468
-4
@@ -22,7 +22,7 @@ POST /openapi/capcut-mate/v1/add_videos
|
||||
```json
|
||||
{
|
||||
"draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258",
|
||||
"video_infos": "[{\"video_url\":\"https://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":5000000,\"mask\":\"圆形\",\"transition\":\"淡入淡出\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"video_infos": "[{\"video_url\":\"https://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":5000000,\"mask\":\"圆形\",\"transition\":\"叠化\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"scene_timelines": [{"start":0,"end":2500000}],
|
||||
"alpha": 0.5,
|
||||
"scale_x": 1.0,
|
||||
@@ -56,7 +56,7 @@ POST /openapi/capcut-mate/v1/add_videos
|
||||
| end | number | ✅ | - | 视频结束播放时间(微秒) |
|
||||
| duration | number | ❌ | end-start | 视频总时长(微秒) |
|
||||
| mask | string | ❌ | - | 遮罩类型 |
|
||||
| transition | string | ❌ | - | 转场效果名称 |
|
||||
| transition | string | ❌ | - | 转场名称，须为下方「支持的转场名称」列表中的值 |
|
||||
| transition_duration | number | ❌ | 500000 | 转场持续时间(微秒) |
|
||||
| volume | number | ❌ | 1.0 | 音量大小(0-1) |
|
||||
|
||||
@@ -108,7 +108,7 @@ POST /openapi/capcut-mate/v1/add_videos
|
||||
|
||||
#### 转场效果
|
||||
|
||||
- **transition**: 转场效果名称
|
||||
- **transition**: 转场名称，须为下方「支持的转场名称」列表中的值
|
||||
- **transition_duration**: 转场持续时间
|
||||
- 最小值：100,000微秒（0.1秒）
|
||||
- 最大值：2,500,000微秒（2.5秒）
|
||||
@@ -141,6 +141,470 @@ POST /openapi/capcut-mate/v1/add_videos
|
||||
// 结果：视频以2倍速播放，实际播放时长为1秒
|
||||
```
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### 支持的转场名称（transition 可用值）
|
||||
|
||||
下列名称可直接作为 `video_infos` 中 `transition` 的值（与剪映端展示名一致）。未匹配到时该转场不会生效。
|
||||
|
||||
当前共 **453** 种转场：
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
|
||||
## 响应格式
|
||||
|
||||
### 成功响应 (200)
|
||||
@@ -197,7 +661,7 @@ 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://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":10000000,\"mask\":\"圆形\",\"transition\":\"淡入淡出\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"video_infos": "[{\"video_url\":\"https://assets.jcaigc.cn/video1.mp4\",\"width\":1024,\"height\":1024,\"start\":0,\"end\":5000000,\"duration\":10000000,\"mask\":\"圆形\",\"transition\":\"叠化\",\"transition_duration\":500000,\"volume\":0.8}]",
|
||||
"alpha": 1.0,
|
||||
"scale_x": 1.2,
|
||||
"scale_y": 1.2
|
||||
|
||||
+6
-883
@@ -47,895 +47,18 @@ Generate image information based on image URLs and timelines. This interface con
|
||||
| timelines | array[object] |✅ | - | Timeline configuration array |
|
||||
| height | number |❌ | 1080 | Image height |
|
||||
| width | number |❌ | 1920 | Image width |
|
||||
| in_animation | string |❌ | None | Intro animation name from Intro animations below |
|
||||
| in_animation | string |❌ | None | Intro animation name; see [add_images](./add_images.md) |
|
||||
| in_animation_duration | number |❌ | 500000 | Entrance animation duration (microseconds) |
|
||||
| loop_animation | string |❌ | None | Loop animation name from Loop animations below |
|
||||
| loop_animation | string |❌ | None | Loop animation name; see [add_images](./add_images.md) |
|
||||
| loop_animation_duration | number |❌ | 1000000 | Loop animation duration (microseconds) |
|
||||
| out_animation | string |❌ | None | Outro animation name from Outro animations below |
|
||||
| out_animation | string |❌ | None | Outro animation name; see [add_images](./add_images.md) |
|
||||
| out_animation_duration | number |❌ | 500000 | Exit animation duration (microseconds) |
|
||||
| transition | string |❌ | None | Transition name from Transitions below |
|
||||
| transition | string |❌ | None | Transition name; see [add_images](./add_images.md) / [add_videos](./add_videos.md) |
|
||||
| transition_duration | number |❌ | 300000 | Transition duration (microseconds) |
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### Supported Transitions and Animations
|
||||
### Available Transitions and Animations
|
||||
|
||||
Use the names below directly as field values (same as CapCut/Jianying display names). Unmatched names are ignored.
|
||||
|
||||
#### Transitions (transition, 453 total)
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
|
||||
#### Intro animations (in_animation, 155 total)
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
上下抖动
|
||||
九宫格
|
||||
交叉震动
|
||||
交错开幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
动感放大
|
||||
动感缩小
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转入
|
||||
向上转入 II
|
||||
向上闪入
|
||||
向下滑动
|
||||
向下甩入
|
||||
向下甩动
|
||||
向右上甩入
|
||||
向右下甩入
|
||||
向右滑动
|
||||
向右甩入
|
||||
向右转入
|
||||
向左上甩入
|
||||
向左下甩入
|
||||
向左滑动
|
||||
向左转入
|
||||
四屏转换
|
||||
圆形开幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
展开
|
||||
左右抖动
|
||||
幸运圣诞树
|
||||
开辟2025
|
||||
弹力分割
|
||||
弹近
|
||||
录像带分屏
|
||||
心形放大
|
||||
快速翻页
|
||||
手写云朵
|
||||
手机倒数
|
||||
扫描
|
||||
抖动下降
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠开幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑入
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转开幕
|
||||
时间倒计时
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
果冻 I
|
||||
果冻 II
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐显
|
||||
游蛇开幕
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
点开
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃聚集
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
神奇弹窗
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方分体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻书
|
||||
翻入
|
||||
翻卡
|
||||
老电视
|
||||
聚合
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转开幕
|
||||
转圈圈
|
||||
轻微抖动
|
||||
轻微抖动 II
|
||||
轻微抖动 III
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钟摆
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面组成
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雨刷
|
||||
雨刷 II
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震撼倒数
|
||||
震波
|
||||
震波 II
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飞近
|
||||
马赛克
|
||||
魔方 III
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### Outro animations (out_animation, 124 total)
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
九宫格
|
||||
交叉震动
|
||||
交错闭幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转出
|
||||
向上转出 II
|
||||
向上闪出
|
||||
向下滑动
|
||||
向下甩动
|
||||
向右滑动
|
||||
向左滑动
|
||||
四屏转换
|
||||
圆形闭幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
幕布
|
||||
幸运圣诞树
|
||||
弹力分割
|
||||
弹远
|
||||
录像带分屏
|
||||
心形缩小
|
||||
快速翻页
|
||||
手写云朵
|
||||
扫描
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠
|
||||
折叠闭幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑出
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转闭幕
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐隐
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃爆开
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方合体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻出
|
||||
翻卡
|
||||
老电视
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转闭幕
|
||||
转圈圈
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面拆分
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飘散
|
||||
飞远
|
||||
马赛克
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### Loop animations (loop_animation, 123 total)
|
||||
|
||||
```text
|
||||
三分割
|
||||
三分割 II
|
||||
上下分割
|
||||
上下分割 II
|
||||
上升旋转
|
||||
下降向右
|
||||
下降向左
|
||||
中间分割
|
||||
中间分割 II
|
||||
分身
|
||||
分身 II
|
||||
动感摇晃I
|
||||
动感摇晃II
|
||||
叠叠乐
|
||||
叠叠乐 II
|
||||
叠叠乐 III
|
||||
叠叠乐 IV
|
||||
叠叠乐 V
|
||||
叠叠乐 Ⅵ
|
||||
右拉镜
|
||||
向右下降
|
||||
向右缩小
|
||||
向左下降
|
||||
向左缩小
|
||||
哈哈镜
|
||||
哈哈镜 II
|
||||
四格滑动
|
||||
四格滑动 II
|
||||
四格翻转
|
||||
四格翻转 II
|
||||
四格转动
|
||||
四格转动 II
|
||||
回弹伸缩
|
||||
回忆旋转
|
||||
坠落
|
||||
夹心饼干
|
||||
夹心饼干 II
|
||||
小火车
|
||||
小火车 II
|
||||
小火车 III
|
||||
小火车 IV
|
||||
小陀螺
|
||||
小陀螺 II
|
||||
左右分割
|
||||
左右分割 II
|
||||
左拉镜
|
||||
弹入旋转
|
||||
弹动冲屏
|
||||
形变右缩
|
||||
形变左缩
|
||||
形变缩小
|
||||
悠悠球
|
||||
悠悠球 II
|
||||
手机
|
||||
手机 II
|
||||
手机 III
|
||||
扭曲拉伸
|
||||
抖入放大
|
||||
拉伸扭曲
|
||||
放大弹动
|
||||
斜转
|
||||
斜转 II
|
||||
方片转动
|
||||
方片转动 II
|
||||
旋入晃动
|
||||
旋出渐隐
|
||||
旋转上升
|
||||
旋转伸缩
|
||||
旋转回吸
|
||||
旋转缩小
|
||||
旋转降落
|
||||
晃动旋出
|
||||
水晶
|
||||
水晶 II
|
||||
波动吸收
|
||||
波动放大
|
||||
波动滑出
|
||||
海盗船
|
||||
海盗船 II
|
||||
海盗船 III
|
||||
海盗船 IV
|
||||
滑入波动
|
||||
滑滑梯
|
||||
滑滑梯 II
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相框滑动
|
||||
碎块滑动
|
||||
碎块滑动 II
|
||||
立方体
|
||||
立方体 II
|
||||
立方体 III
|
||||
立方体 IV
|
||||
立方体 V
|
||||
红酒摇晃
|
||||
绕圈圈
|
||||
绕圈圈 II
|
||||
绕圈圈 III
|
||||
绕圈圈 IV
|
||||
缩小弹动
|
||||
缩小旋转
|
||||
缩小转出
|
||||
缩放
|
||||
缩放 II
|
||||
翻转
|
||||
翻转 II
|
||||
翻转 III
|
||||
翻转 IV
|
||||
翻转 V
|
||||
翻转 VI
|
||||
荡秋千
|
||||
荡秋千 II
|
||||
跳跳糖
|
||||
转入转出
|
||||
转入转出 II
|
||||
转圈圈
|
||||
过山车
|
||||
过山车 II
|
||||
闪光放大
|
||||
闪光放大 II
|
||||
降落旋转
|
||||
魔方
|
||||
魔方 II
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
For the full lists of valid `transition` / `in_animation` / `out_animation` / `loop_animation` values, see [add_images](./add_images.md) → Supported Transitions and Animations.
|
||||
|
||||
## Response Format
|
||||
|
||||
|
||||
+6
-883
@@ -47,895 +47,18 @@ POST /openapi/capcut-mate/v1/imgs_infos
|
||||
| timelines | array[object] |✅ | - | 时间线配置数组 |
|
||||
| height | number |❌ | 1080 |图片高度 |
|
||||
| width | number |❌ | 1920 |图片宽度 |
|
||||
| in_animation | string |❌ | None |入场动画名称，须为下方「入场动画」列表中的值 |
|
||||
| in_animation | string |❌ | None |入场动画名称，可用值见 [add_images](./add_images.zh.md) |
|
||||
| in_animation_duration | number |❌ | 500000 |入时长(微秒) |
|
||||
| loop_animation | string |❌ | None |循环动画名称，须为下方「循环动画」列表中的值 |
|
||||
| loop_animation | string |❌ | None |循环动画名称，可用值见 [add_images](./add_images.zh.md) |
|
||||
| loop_animation_duration | number |❌ | 1000000 |循动画时长(微秒) |
|
||||
| out_animation | string |❌ | None |出场动画名称，须为下方「出场动画」列表中的值 |
|
||||
| out_animation | string |❌ | None |出场动画名称，可用值见 [add_images](./add_images.zh.md) |
|
||||
| out_animation_duration | number |❌ | 500000 |出动画时长(微秒) |
|
||||
| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |
|
||||
| transition | string |❌ | None |转场名称，可用值见 [add_images](./add_images.zh.md) / [add_videos](./add_videos.zh.md) |
|
||||
| transition_duration | number |❌ | 300000 |转场时长(微秒) |
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### 支持的转场与动画名称
|
||||
### 可用转场与动画名称
|
||||
|
||||
下列名称可直接作为对应字段的值（与剪映端展示名一致）。未匹配到时该效果不会生效。
|
||||
|
||||
#### 转场（transition，共 453 种）
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
|
||||
#### 入场动画（in_animation，共 155 种）
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
上下抖动
|
||||
九宫格
|
||||
交叉震动
|
||||
交错开幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
动感放大
|
||||
动感缩小
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转入
|
||||
向上转入 II
|
||||
向上闪入
|
||||
向下滑动
|
||||
向下甩入
|
||||
向下甩动
|
||||
向右上甩入
|
||||
向右下甩入
|
||||
向右滑动
|
||||
向右甩入
|
||||
向右转入
|
||||
向左上甩入
|
||||
向左下甩入
|
||||
向左滑动
|
||||
向左转入
|
||||
四屏转换
|
||||
圆形开幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
展开
|
||||
左右抖动
|
||||
幸运圣诞树
|
||||
开辟2025
|
||||
弹力分割
|
||||
弹近
|
||||
录像带分屏
|
||||
心形放大
|
||||
快速翻页
|
||||
手写云朵
|
||||
手机倒数
|
||||
扫描
|
||||
抖动下降
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠开幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑入
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转开幕
|
||||
时间倒计时
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
果冻 I
|
||||
果冻 II
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐显
|
||||
游蛇开幕
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
点开
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃聚集
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
神奇弹窗
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方分体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻书
|
||||
翻入
|
||||
翻卡
|
||||
老电视
|
||||
聚合
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转开幕
|
||||
转圈圈
|
||||
轻微抖动
|
||||
轻微抖动 II
|
||||
轻微抖动 III
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钟摆
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面组成
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雨刷
|
||||
雨刷 II
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震撼倒数
|
||||
震波
|
||||
震波 II
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飞近
|
||||
马赛克
|
||||
魔方 III
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### 出场动画（out_animation，共 124 种）
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
九宫格
|
||||
交叉震动
|
||||
交错闭幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转出
|
||||
向上转出 II
|
||||
向上闪出
|
||||
向下滑动
|
||||
向下甩动
|
||||
向右滑动
|
||||
向左滑动
|
||||
四屏转换
|
||||
圆形闭幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
幕布
|
||||
幸运圣诞树
|
||||
弹力分割
|
||||
弹远
|
||||
录像带分屏
|
||||
心形缩小
|
||||
快速翻页
|
||||
手写云朵
|
||||
扫描
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠
|
||||
折叠闭幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑出
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转闭幕
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐隐
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃爆开
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方合体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻出
|
||||
翻卡
|
||||
老电视
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转闭幕
|
||||
转圈圈
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面拆分
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飘散
|
||||
飞远
|
||||
马赛克
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### 循环动画（loop_animation，共 123 种）
|
||||
|
||||
```text
|
||||
三分割
|
||||
三分割 II
|
||||
上下分割
|
||||
上下分割 II
|
||||
上升旋转
|
||||
下降向右
|
||||
下降向左
|
||||
中间分割
|
||||
中间分割 II
|
||||
分身
|
||||
分身 II
|
||||
动感摇晃I
|
||||
动感摇晃II
|
||||
叠叠乐
|
||||
叠叠乐 II
|
||||
叠叠乐 III
|
||||
叠叠乐 IV
|
||||
叠叠乐 V
|
||||
叠叠乐 Ⅵ
|
||||
右拉镜
|
||||
向右下降
|
||||
向右缩小
|
||||
向左下降
|
||||
向左缩小
|
||||
哈哈镜
|
||||
哈哈镜 II
|
||||
四格滑动
|
||||
四格滑动 II
|
||||
四格翻转
|
||||
四格翻转 II
|
||||
四格转动
|
||||
四格转动 II
|
||||
回弹伸缩
|
||||
回忆旋转
|
||||
坠落
|
||||
夹心饼干
|
||||
夹心饼干 II
|
||||
小火车
|
||||
小火车 II
|
||||
小火车 III
|
||||
小火车 IV
|
||||
小陀螺
|
||||
小陀螺 II
|
||||
左右分割
|
||||
左右分割 II
|
||||
左拉镜
|
||||
弹入旋转
|
||||
弹动冲屏
|
||||
形变右缩
|
||||
形变左缩
|
||||
形变缩小
|
||||
悠悠球
|
||||
悠悠球 II
|
||||
手机
|
||||
手机 II
|
||||
手机 III
|
||||
扭曲拉伸
|
||||
抖入放大
|
||||
拉伸扭曲
|
||||
放大弹动
|
||||
斜转
|
||||
斜转 II
|
||||
方片转动
|
||||
方片转动 II
|
||||
旋入晃动
|
||||
旋出渐隐
|
||||
旋转上升
|
||||
旋转伸缩
|
||||
旋转回吸
|
||||
旋转缩小
|
||||
旋转降落
|
||||
晃动旋出
|
||||
水晶
|
||||
水晶 II
|
||||
波动吸收
|
||||
波动放大
|
||||
波动滑出
|
||||
海盗船
|
||||
海盗船 II
|
||||
海盗船 III
|
||||
海盗船 IV
|
||||
滑入波动
|
||||
滑滑梯
|
||||
滑滑梯 II
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相框滑动
|
||||
碎块滑动
|
||||
碎块滑动 II
|
||||
立方体
|
||||
立方体 II
|
||||
立方体 III
|
||||
立方体 IV
|
||||
立方体 V
|
||||
红酒摇晃
|
||||
绕圈圈
|
||||
绕圈圈 II
|
||||
绕圈圈 III
|
||||
绕圈圈 IV
|
||||
缩小弹动
|
||||
缩小旋转
|
||||
缩小转出
|
||||
缩放
|
||||
缩放 II
|
||||
翻转
|
||||
翻转 II
|
||||
翻转 III
|
||||
翻转 IV
|
||||
翻转 V
|
||||
翻转 VI
|
||||
荡秋千
|
||||
荡秋千 II
|
||||
跳跳糖
|
||||
转入转出
|
||||
转入转出 II
|
||||
转圈圈
|
||||
过山车
|
||||
过山车 II
|
||||
闪光放大
|
||||
闪光放大 II
|
||||
降落旋转
|
||||
魔方
|
||||
魔方 II
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
转场、入场/出场/循环动画的完整可用值清单，请参见 [添加图片（add_images）](./add_images.zh.md) 文档中的「支持的转场与动画名称」。
|
||||
|
||||
##响应格式
|
||||
|
||||
|
||||
+3
-882
@@ -44,892 +44,13 @@ Generate video information based on video URLs and timelines. This interface con
|
||||
| height | number |❌ | 1080 | Video height |
|
||||
| width | number |❌ | 1920 | Video width |
|
||||
| mask | string |❌ | None | Mask type |
|
||||
| transition | string |❌ | None | Transition name from Transitions below |
|
||||
| transition | string |❌ | None | Transition name; see [add_videos](./add_videos.md) |
|
||||
| transition_duration | number |❌ | 300000 | Transition duration (microseconds) |
|
||||
| volume | number |❌ | 1.0 | Volume level (0.0-2.0) |
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### Supported Transitions and Animations
|
||||
### Available Transition Names
|
||||
|
||||
Use the names below directly as field values (same as CapCut/Jianying display names). Unmatched names are ignored.
|
||||
|
||||
Note: `video_infos` currently only accepts `transition` in the request. Intro/outro/loop names below match image/clip animations and can be used with `imgs_infos` / `add_images`.
|
||||
|
||||
#### Transitions (transition, 453 total)
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
|
||||
#### Intro animations (in_animation, 155 total)
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
上下抖动
|
||||
九宫格
|
||||
交叉震动
|
||||
交错开幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
动感放大
|
||||
动感缩小
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转入
|
||||
向上转入 II
|
||||
向上闪入
|
||||
向下滑动
|
||||
向下甩入
|
||||
向下甩动
|
||||
向右上甩入
|
||||
向右下甩入
|
||||
向右滑动
|
||||
向右甩入
|
||||
向右转入
|
||||
向左上甩入
|
||||
向左下甩入
|
||||
向左滑动
|
||||
向左转入
|
||||
四屏转换
|
||||
圆形开幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
展开
|
||||
左右抖动
|
||||
幸运圣诞树
|
||||
开辟2025
|
||||
弹力分割
|
||||
弹近
|
||||
录像带分屏
|
||||
心形放大
|
||||
快速翻页
|
||||
手写云朵
|
||||
手机倒数
|
||||
扫描
|
||||
抖动下降
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠开幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑入
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转开幕
|
||||
时间倒计时
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
果冻 I
|
||||
果冻 II
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐显
|
||||
游蛇开幕
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
点开
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃聚集
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
神奇弹窗
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方分体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻书
|
||||
翻入
|
||||
翻卡
|
||||
老电视
|
||||
聚合
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转开幕
|
||||
转圈圈
|
||||
轻微抖动
|
||||
轻微抖动 II
|
||||
轻微抖动 III
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钟摆
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面组成
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雨刷
|
||||
雨刷 II
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震撼倒数
|
||||
震波
|
||||
震波 II
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飞近
|
||||
马赛克
|
||||
魔方 III
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### Outro animations (out_animation, 124 total)
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
九宫格
|
||||
交叉震动
|
||||
交错闭幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转出
|
||||
向上转出 II
|
||||
向上闪出
|
||||
向下滑动
|
||||
向下甩动
|
||||
向右滑动
|
||||
向左滑动
|
||||
四屏转换
|
||||
圆形闭幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
幕布
|
||||
幸运圣诞树
|
||||
弹力分割
|
||||
弹远
|
||||
录像带分屏
|
||||
心形缩小
|
||||
快速翻页
|
||||
手写云朵
|
||||
扫描
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠
|
||||
折叠闭幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑出
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转闭幕
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐隐
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃爆开
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方合体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻出
|
||||
翻卡
|
||||
老电视
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转闭幕
|
||||
转圈圈
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面拆分
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飘散
|
||||
飞远
|
||||
马赛克
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### Loop animations (loop_animation, 123 total)
|
||||
|
||||
```text
|
||||
三分割
|
||||
三分割 II
|
||||
上下分割
|
||||
上下分割 II
|
||||
上升旋转
|
||||
下降向右
|
||||
下降向左
|
||||
中间分割
|
||||
中间分割 II
|
||||
分身
|
||||
分身 II
|
||||
动感摇晃I
|
||||
动感摇晃II
|
||||
叠叠乐
|
||||
叠叠乐 II
|
||||
叠叠乐 III
|
||||
叠叠乐 IV
|
||||
叠叠乐 V
|
||||
叠叠乐 Ⅵ
|
||||
右拉镜
|
||||
向右下降
|
||||
向右缩小
|
||||
向左下降
|
||||
向左缩小
|
||||
哈哈镜
|
||||
哈哈镜 II
|
||||
四格滑动
|
||||
四格滑动 II
|
||||
四格翻转
|
||||
四格翻转 II
|
||||
四格转动
|
||||
四格转动 II
|
||||
回弹伸缩
|
||||
回忆旋转
|
||||
坠落
|
||||
夹心饼干
|
||||
夹心饼干 II
|
||||
小火车
|
||||
小火车 II
|
||||
小火车 III
|
||||
小火车 IV
|
||||
小陀螺
|
||||
小陀螺 II
|
||||
左右分割
|
||||
左右分割 II
|
||||
左拉镜
|
||||
弹入旋转
|
||||
弹动冲屏
|
||||
形变右缩
|
||||
形变左缩
|
||||
形变缩小
|
||||
悠悠球
|
||||
悠悠球 II
|
||||
手机
|
||||
手机 II
|
||||
手机 III
|
||||
扭曲拉伸
|
||||
抖入放大
|
||||
拉伸扭曲
|
||||
放大弹动
|
||||
斜转
|
||||
斜转 II
|
||||
方片转动
|
||||
方片转动 II
|
||||
旋入晃动
|
||||
旋出渐隐
|
||||
旋转上升
|
||||
旋转伸缩
|
||||
旋转回吸
|
||||
旋转缩小
|
||||
旋转降落
|
||||
晃动旋出
|
||||
水晶
|
||||
水晶 II
|
||||
波动吸收
|
||||
波动放大
|
||||
波动滑出
|
||||
海盗船
|
||||
海盗船 II
|
||||
海盗船 III
|
||||
海盗船 IV
|
||||
滑入波动
|
||||
滑滑梯
|
||||
滑滑梯 II
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相框滑动
|
||||
碎块滑动
|
||||
碎块滑动 II
|
||||
立方体
|
||||
立方体 II
|
||||
立方体 III
|
||||
立方体 IV
|
||||
立方体 V
|
||||
红酒摇晃
|
||||
绕圈圈
|
||||
绕圈圈 II
|
||||
绕圈圈 III
|
||||
绕圈圈 IV
|
||||
缩小弹动
|
||||
缩小旋转
|
||||
缩小转出
|
||||
缩放
|
||||
缩放 II
|
||||
翻转
|
||||
翻转 II
|
||||
翻转 III
|
||||
翻转 IV
|
||||
翻转 V
|
||||
翻转 VI
|
||||
荡秋千
|
||||
荡秋千 II
|
||||
跳跳糖
|
||||
转入转出
|
||||
转入转出 II
|
||||
转圈圈
|
||||
过山车
|
||||
过山车 II
|
||||
闪光放大
|
||||
闪光放大 II
|
||||
降落旋转
|
||||
魔方
|
||||
魔方 II
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
For the full list of valid `transition` values, see [add_videos](./add_videos.md) → Supported Transition Names. For intro/outro/loop clip animations, see [add_images](./add_images.md).
|
||||
|
||||
## Response Format
|
||||
|
||||
|
||||
+3
-882
@@ -44,892 +44,13 @@ POST /openapi/capcut-mate/v1/video_infos
|
||||
| height | number |❌ | 1080 |视频高度 |
|
||||
| width | number |❌ | 1920 |视频宽度 |
|
||||
| mask | string |❌ | None |遮罩类型 |
|
||||
| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |
|
||||
| transition | string |❌ | None |转场名称，可用值见 [add_videos](./add_videos.zh.md) |
|
||||
| transition_duration | number |❌ | 300000 |转场时长(微秒) |
|
||||
| volume | number |❌ | 1.0 |音量大小(0.0-2.0) |
|
||||
|
||||
<!-- MEDIA_EFFECT_LIST_START -->
|
||||
### 支持的转场与动画名称
|
||||
### 可用转场名称
|
||||
|
||||
下列名称可直接作为对应字段的值（与剪映端展示名一致）。未匹配到时该效果不会生效。
|
||||
|
||||
说明：`video_infos` 请求参数目前仅包含 `transition`；下列入场/出场/循环动画与图片画面动画同源，可直接用于 `imgs_infos` / `add_images` 等接口的同名字段。
|
||||
|
||||
#### 转场（transition，共 453 种）
|
||||
|
||||
```text
|
||||
2024回忆流
|
||||
3D空间
|
||||
X形震闪
|
||||
万花筒
|
||||
三屏放大
|
||||
三屏滑入
|
||||
三屏闪切
|
||||
上下翻页
|
||||
上移
|
||||
下滑
|
||||
下移
|
||||
中心切开
|
||||
中心旋转
|
||||
二次元烟效
|
||||
云朵
|
||||
云朵 II
|
||||
亮点模糊
|
||||
便利贴
|
||||
信号故障
|
||||
信号故障 II
|
||||
倒影
|
||||
倾斜拉伸
|
||||
倾斜拉开
|
||||
倾斜模糊
|
||||
像素冲屏
|
||||
光束
|
||||
全息投影
|
||||
六边形变焦
|
||||
冰雪结晶
|
||||
冲屏扭曲
|
||||
冲鸭
|
||||
几何分割
|
||||
几何滑动
|
||||
分割
|
||||
分割 II
|
||||
分割 III
|
||||
分割 IV
|
||||
分屏下滑
|
||||
前后对比
|
||||
前后对比 II
|
||||
剧烈摇晃
|
||||
动漫云朵
|
||||
动漫漩涡
|
||||
动漫火焰
|
||||
动漫闪电
|
||||
卡片弹出
|
||||
压缩
|
||||
发光变焦
|
||||
叠加
|
||||
叠化
|
||||
叠化扭曲
|
||||
可爱爆炸
|
||||
可爱龙龙
|
||||
右移
|
||||
吃掉
|
||||
后台切换
|
||||
向上
|
||||
向上擦除
|
||||
向上波动
|
||||
向下
|
||||
向下抖动
|
||||
向下拖拽
|
||||
向下擦除
|
||||
向下流动
|
||||
向右
|
||||
向右上
|
||||
向右下
|
||||
向右拉伸
|
||||
向右擦除
|
||||
向右流动
|
||||
向左
|
||||
向左上
|
||||
向左下
|
||||
向左拉伸
|
||||
向左拉屏
|
||||
向左擦除
|
||||
向左波动
|
||||
吸入
|
||||
喜欢
|
||||
四屏转换
|
||||
四格展开
|
||||
回忆
|
||||
回忆 II
|
||||
回忆下滑
|
||||
回忆拉屏
|
||||
回忆拉屏 II
|
||||
图片放大
|
||||
圆形分割
|
||||
圆形分割 II
|
||||
圆形扫描
|
||||
圆形遮罩
|
||||
圆形遮罩 II
|
||||
圆盘旋转
|
||||
圣诞光斑
|
||||
圣诞光斑II
|
||||
圣诞树
|
||||
圣诞礼盒
|
||||
复古叠影
|
||||
复古放映
|
||||
复古放映 II
|
||||
复古漏光
|
||||
复古漏光 II
|
||||
复古胶片
|
||||
多层环形
|
||||
多屏定格
|
||||
大圆盘
|
||||
大波浪
|
||||
字母拼贴
|
||||
射灯
|
||||
小喇叭
|
||||
小恶魔
|
||||
岁月的痕迹
|
||||
左下角 II
|
||||
左移
|
||||
左移弹动
|
||||
幻影
|
||||
幻觉
|
||||
开幕
|
||||
开心
|
||||
弹出
|
||||
弹动发光
|
||||
弹幕转场
|
||||
弹跳
|
||||
彩色像素
|
||||
彩色滑片
|
||||
往上翻页
|
||||
微抖动
|
||||
心形叠化
|
||||
快涂擦除
|
||||
快速缩放
|
||||
快速震闪
|
||||
快门
|
||||
惊悚屏闪
|
||||
手机屏放大
|
||||
打板转场 I
|
||||
打板转场 II
|
||||
扫光
|
||||
扭曲弹动
|
||||
扭曲旋入
|
||||
扭曲溶解
|
||||
扭转弹动
|
||||
抖动
|
||||
抖动 II
|
||||
抖动放大
|
||||
抖动缩小
|
||||
抖动缩小 II
|
||||
折痕胶带
|
||||
抠像旋转
|
||||
抽象前景
|
||||
抽象前景 II
|
||||
拉伸
|
||||
拉伸 II
|
||||
拉开
|
||||
拉框入屏
|
||||
拉远
|
||||
拍摄器
|
||||
拍摄器 II
|
||||
拍摄器 III
|
||||
挤压分屏
|
||||
推近
|
||||
推近 II
|
||||
推远 II
|
||||
摄像机
|
||||
摇晃描边
|
||||
摇晃震动
|
||||
摇镜
|
||||
撕纸
|
||||
撕纸拉屏
|
||||
撕纸掉落
|
||||
收缩抖动
|
||||
放大左移
|
||||
放大镜
|
||||
放射
|
||||
故障
|
||||
故障扫描
|
||||
故障拼贴
|
||||
故障模糊
|
||||
数字矩阵
|
||||
斜向分割
|
||||
斜向模糊
|
||||
斜向闪光
|
||||
斜线翻页
|
||||
新篇章
|
||||
新篇章 II
|
||||
方形分割
|
||||
方形变焦
|
||||
方形模糊
|
||||
方形模糊 II
|
||||
方片翻转
|
||||
旋焦
|
||||
旋转圆球
|
||||
旋转圆盘
|
||||
旋转圆盘 II
|
||||
旋转快门
|
||||
旋转拨盘
|
||||
旋转模糊
|
||||
旋转穿越
|
||||
旋转纵深
|
||||
旋转翻页
|
||||
旋转震动
|
||||
无缝撕裂
|
||||
无限穿越 I
|
||||
无限穿越 II
|
||||
日历转场
|
||||
旧胶片
|
||||
旧胶片 II
|
||||
时光穿梭
|
||||
星光
|
||||
星光叠化
|
||||
星光炸开
|
||||
星星
|
||||
星星 II
|
||||
星星 III
|
||||
星星变焦
|
||||
星星吸入
|
||||
星星模糊
|
||||
春日光斑
|
||||
暧昧光晕
|
||||
曝光拉丝
|
||||
曝光摇镜
|
||||
未来光谱
|
||||
未来光谱II
|
||||
条形模糊
|
||||
模糊
|
||||
模糊放大
|
||||
模糊细闪
|
||||
模糊缩小
|
||||
横向分割
|
||||
横向分屏
|
||||
横向拉幕
|
||||
横向模糊
|
||||
横向滑动
|
||||
横向震动
|
||||
横条挤压
|
||||
横移模糊
|
||||
横线
|
||||
樱花飞舞
|
||||
气泡转场
|
||||
水墨
|
||||
水波卷动
|
||||
水波向右
|
||||
水波向左
|
||||
水滴
|
||||
水滴 II
|
||||
水滴 III
|
||||
水滴溶解
|
||||
汇聚
|
||||
泛光
|
||||
泛白
|
||||
泡泡模糊
|
||||
波光粼粼
|
||||
波动
|
||||
波动 II
|
||||
波动故障
|
||||
波点向右
|
||||
泼墨晕染
|
||||
流光
|
||||
涂鸦放大
|
||||
渐变擦除
|
||||
溶解推进
|
||||
滑动
|
||||
滑动压迫感
|
||||
滑动弹出
|
||||
滑动放大
|
||||
滑块拼贴
|
||||
滚动立方
|
||||
漩涡
|
||||
漩涡扭曲
|
||||
漫画撕纸
|
||||
火焰湍流
|
||||
炫光
|
||||
炫光 II
|
||||
炫光 III
|
||||
炫光弹动
|
||||
炫光扫描
|
||||
炫光扭动
|
||||
炸弹
|
||||
烟花光斑
|
||||
烟雾弹
|
||||
烟雾转场
|
||||
热成像
|
||||
燃烧
|
||||
燃烧 II
|
||||
燃烧 III
|
||||
爆米花
|
||||
爆闪
|
||||
爆闪 II
|
||||
爱心
|
||||
爱心 II
|
||||
爱心上升
|
||||
爱心冲击
|
||||
爱心模糊
|
||||
爱心气球
|
||||
爱心软糖
|
||||
爱心遮罩
|
||||
环回推近
|
||||
环形色散
|
||||
玻璃破碎
|
||||
玻璃破碎 II
|
||||
珠光模糊
|
||||
生气
|
||||
电光
|
||||
电光 II
|
||||
电流
|
||||
电视故障 I
|
||||
电视故障 II
|
||||
画笔擦除
|
||||
畸变回弹
|
||||
白光快闪
|
||||
白色墨花
|
||||
白色烟雾
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相机缩小
|
||||
相片切换
|
||||
相片拼贴
|
||||
眨眼
|
||||
矩形分割
|
||||
礼物落下
|
||||
空间上移
|
||||
空间弹动
|
||||
空间弹动 II
|
||||
空间弹动 III
|
||||
空间弹动 IV
|
||||
空间旋转
|
||||
空间旋转 II
|
||||
空间旋转 III
|
||||
空间翻转
|
||||
空间翻转 II
|
||||
空间跳跃
|
||||
穿越
|
||||
穿越 II
|
||||
穿越 III
|
||||
窗格
|
||||
立体旋转
|
||||
立体翻转
|
||||
立体翻页
|
||||
立体翻页 II
|
||||
立方体
|
||||
立方旋转
|
||||
竖向分割
|
||||
竖向拉伸
|
||||
竖向拉幕
|
||||
竖向模糊
|
||||
竖向模糊 II
|
||||
竖移模糊
|
||||
竖线
|
||||
笔迹涂抹
|
||||
箭头向右
|
||||
粉色反转片
|
||||
粒子
|
||||
红包雨
|
||||
纵向滑动
|
||||
纸团
|
||||
翻书转场
|
||||
翻篇
|
||||
翻转冲屏
|
||||
翻页
|
||||
翻页 II
|
||||
聚光灯
|
||||
胶卷滑动
|
||||
胶片切闪
|
||||
胶片定格
|
||||
胶片擦除
|
||||
胶片融化
|
||||
胶片闪光
|
||||
色块故障
|
||||
色差故障
|
||||
色差逆时针
|
||||
色差顺时针
|
||||
色彩溶解
|
||||
色彩溶解 II
|
||||
色彩溶解 III
|
||||
色彩溶解 IV
|
||||
色彩溶解 V
|
||||
色彩负片
|
||||
色散晃镜
|
||||
色散波纹
|
||||
色散漩涡
|
||||
色散闪烁
|
||||
色散闪烁 II
|
||||
草图转场
|
||||
荧光爆闪
|
||||
菱格翻转
|
||||
蓝光扫描
|
||||
蓝色反转片
|
||||
蓝色线条
|
||||
虹光旋入
|
||||
融化
|
||||
融化 II
|
||||
课本转场
|
||||
负片下滑
|
||||
赛博马赛克
|
||||
超赞
|
||||
边框切换
|
||||
运镜压缩
|
||||
迷幻波纹
|
||||
迷幻频闪
|
||||
逆时针旋转
|
||||
逆时针旋转 II
|
||||
透镜故障
|
||||
重叠上滑
|
||||
金币祝福
|
||||
金沙
|
||||
金色光斑
|
||||
钱兔无量
|
||||
镜像翻转
|
||||
镜头速移
|
||||
长曝光
|
||||
闪光灯
|
||||
闪光灯 II
|
||||
闪光灯 III
|
||||
闪动光斑
|
||||
闪动光斑 II
|
||||
闪回
|
||||
闪屏故障
|
||||
闪白
|
||||
闪白 II
|
||||
闪黑
|
||||
闪黑 II
|
||||
闹钟
|
||||
雨刷转场
|
||||
雪花叠化
|
||||
雪花四散
|
||||
雪花故障
|
||||
雪花环绕
|
||||
雪雾
|
||||
雾化
|
||||
震动
|
||||
震动 II
|
||||
震动缩小
|
||||
霓虹闪光
|
||||
霓虹闪光 II
|
||||
顺时针三角
|
||||
顺时针旋转
|
||||
顺时针旋转 II
|
||||
频闪
|
||||
风车
|
||||
飘雪
|
||||
飘雪 II
|
||||
马赛克
|
||||
马赛克 II
|
||||
马赛克III
|
||||
鱼眼
|
||||
鱼眼 II
|
||||
鱼眼 III
|
||||
鱼眼波纹
|
||||
鸿运四叶草
|
||||
黑板擦除
|
||||
黑白摇镜
|
||||
黑色反转片
|
||||
黑色块
|
||||
黑色烟雾
|
||||
```
|
||||
|
||||
#### 入场动画（in_animation，共 155 种）
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
上下抖动
|
||||
九宫格
|
||||
交叉震动
|
||||
交错开幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
动感放大
|
||||
动感缩小
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转入
|
||||
向上转入 II
|
||||
向上闪入
|
||||
向下滑动
|
||||
向下甩入
|
||||
向下甩动
|
||||
向右上甩入
|
||||
向右下甩入
|
||||
向右滑动
|
||||
向右甩入
|
||||
向右转入
|
||||
向左上甩入
|
||||
向左下甩入
|
||||
向左滑动
|
||||
向左转入
|
||||
四屏转换
|
||||
圆形开幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
展开
|
||||
左右抖动
|
||||
幸运圣诞树
|
||||
开辟2025
|
||||
弹力分割
|
||||
弹近
|
||||
录像带分屏
|
||||
心形放大
|
||||
快速翻页
|
||||
手写云朵
|
||||
手机倒数
|
||||
扫描
|
||||
抖动下降
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠开幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑入
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转开幕
|
||||
时间倒计时
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
果冻 I
|
||||
果冻 II
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐显
|
||||
游蛇开幕
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
点开
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃聚集
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
神奇弹窗
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方分体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻书
|
||||
翻入
|
||||
翻卡
|
||||
老电视
|
||||
聚合
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转开幕
|
||||
转圈圈
|
||||
轻微抖动
|
||||
轻微抖动 II
|
||||
轻微抖动 III
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钟摆
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面组成
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雨刷
|
||||
雨刷 II
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震撼倒数
|
||||
震波
|
||||
震波 II
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飞近
|
||||
马赛克
|
||||
魔方 III
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### 出场动画（out_animation，共 124 种）
|
||||
|
||||
```text
|
||||
2024
|
||||
2025
|
||||
Kira游动
|
||||
PASSION
|
||||
三屏下滑
|
||||
三屏切闪
|
||||
九宫格
|
||||
交叉震动
|
||||
交错闭幕
|
||||
侧滑
|
||||
便利贴
|
||||
冬季雪花
|
||||
冰块
|
||||
冰雪融化
|
||||
冲撞
|
||||
分屏横移
|
||||
分屏组合
|
||||
分屏翻转
|
||||
分身模糊
|
||||
划水
|
||||
区域色块滑动
|
||||
十字震动
|
||||
卡片扫光
|
||||
发光矩形
|
||||
变速扩大
|
||||
变速时空
|
||||
向上滑动
|
||||
向上滚动
|
||||
向上转出
|
||||
向上转出 II
|
||||
向上闪出
|
||||
向下滑动
|
||||
向下甩动
|
||||
向右滑动
|
||||
向左滑动
|
||||
四屏转换
|
||||
圆形闭幕
|
||||
多层环形
|
||||
多屏分割I
|
||||
多屏分割II
|
||||
多维空间
|
||||
幕布
|
||||
幸运圣诞树
|
||||
弹力分割
|
||||
弹远
|
||||
录像带分屏
|
||||
心形缩小
|
||||
快速翻页
|
||||
手写云朵
|
||||
扫描
|
||||
抖动变焦
|
||||
抖动横移
|
||||
折叠
|
||||
折叠闭幕
|
||||
报纸拼贴
|
||||
报纸拼贴Ⅱ
|
||||
拉丝滑出
|
||||
拼图
|
||||
探灯聚焦
|
||||
放大
|
||||
斜切
|
||||
斜向拉丝
|
||||
旋转
|
||||
旋转圆球
|
||||
旋转闭幕
|
||||
晃动抽帧
|
||||
曝光放射
|
||||
枫叶遮罩
|
||||
模糊聚焦
|
||||
横向模糊
|
||||
水墨
|
||||
水滴遮罩
|
||||
油画描边变色
|
||||
波纹弹动
|
||||
流金
|
||||
渐隐
|
||||
滑片滑动
|
||||
漩涡旋转
|
||||
灼烧出现
|
||||
烟雾弹
|
||||
照片回忆
|
||||
爱心碰撞
|
||||
玫瑰
|
||||
玻璃爆开
|
||||
画出爱心
|
||||
画面擦除
|
||||
砸出波纹
|
||||
空间扭曲
|
||||
立体交叉
|
||||
立体翻转
|
||||
立方合体
|
||||
竖向拼接
|
||||
粒子爱心
|
||||
缩小
|
||||
翻出
|
||||
翻卡
|
||||
老电视
|
||||
能量立方
|
||||
脉冲
|
||||
色散波纹
|
||||
荧光爆闪
|
||||
负片闪屏
|
||||
跳转闭幕
|
||||
转圈圈
|
||||
轻微放大
|
||||
迷幻流光
|
||||
金沙
|
||||
钱币遮罩
|
||||
镜像翻转
|
||||
镜面拆分
|
||||
闪屏
|
||||
闪现
|
||||
闪电分屏
|
||||
雪花遮罩
|
||||
震动波纹
|
||||
震波 III
|
||||
鞭炮遮罩
|
||||
音量大小
|
||||
飘散
|
||||
飞远
|
||||
马赛克
|
||||
魔法粒子I
|
||||
魔法粒子II
|
||||
黑白画中画
|
||||
```
|
||||
|
||||
#### 循环动画（loop_animation，共 123 种）
|
||||
|
||||
```text
|
||||
三分割
|
||||
三分割 II
|
||||
上下分割
|
||||
上下分割 II
|
||||
上升旋转
|
||||
下降向右
|
||||
下降向左
|
||||
中间分割
|
||||
中间分割 II
|
||||
分身
|
||||
分身 II
|
||||
动感摇晃I
|
||||
动感摇晃II
|
||||
叠叠乐
|
||||
叠叠乐 II
|
||||
叠叠乐 III
|
||||
叠叠乐 IV
|
||||
叠叠乐 V
|
||||
叠叠乐 Ⅵ
|
||||
右拉镜
|
||||
向右下降
|
||||
向右缩小
|
||||
向左下降
|
||||
向左缩小
|
||||
哈哈镜
|
||||
哈哈镜 II
|
||||
四格滑动
|
||||
四格滑动 II
|
||||
四格翻转
|
||||
四格翻转 II
|
||||
四格转动
|
||||
四格转动 II
|
||||
回弹伸缩
|
||||
回忆旋转
|
||||
坠落
|
||||
夹心饼干
|
||||
夹心饼干 II
|
||||
小火车
|
||||
小火车 II
|
||||
小火车 III
|
||||
小火车 IV
|
||||
小陀螺
|
||||
小陀螺 II
|
||||
左右分割
|
||||
左右分割 II
|
||||
左拉镜
|
||||
弹入旋转
|
||||
弹动冲屏
|
||||
形变右缩
|
||||
形变左缩
|
||||
形变缩小
|
||||
悠悠球
|
||||
悠悠球 II
|
||||
手机
|
||||
手机 II
|
||||
手机 III
|
||||
扭曲拉伸
|
||||
抖入放大
|
||||
拉伸扭曲
|
||||
放大弹动
|
||||
斜转
|
||||
斜转 II
|
||||
方片转动
|
||||
方片转动 II
|
||||
旋入晃动
|
||||
旋出渐隐
|
||||
旋转上升
|
||||
旋转伸缩
|
||||
旋转回吸
|
||||
旋转缩小
|
||||
旋转降落
|
||||
晃动旋出
|
||||
水晶
|
||||
水晶 II
|
||||
波动吸收
|
||||
波动放大
|
||||
波动滑出
|
||||
海盗船
|
||||
海盗船 II
|
||||
海盗船 III
|
||||
海盗船 IV
|
||||
滑入波动
|
||||
滑滑梯
|
||||
滑滑梯 II
|
||||
百叶窗
|
||||
百叶窗 II
|
||||
相框滑动
|
||||
碎块滑动
|
||||
碎块滑动 II
|
||||
立方体
|
||||
立方体 II
|
||||
立方体 III
|
||||
立方体 IV
|
||||
立方体 V
|
||||
红酒摇晃
|
||||
绕圈圈
|
||||
绕圈圈 II
|
||||
绕圈圈 III
|
||||
绕圈圈 IV
|
||||
缩小弹动
|
||||
缩小旋转
|
||||
缩小转出
|
||||
缩放
|
||||
缩放 II
|
||||
翻转
|
||||
翻转 II
|
||||
翻转 III
|
||||
翻转 IV
|
||||
翻转 V
|
||||
翻转 VI
|
||||
荡秋千
|
||||
荡秋千 II
|
||||
跳跳糖
|
||||
转入转出
|
||||
转入转出 II
|
||||
转圈圈
|
||||
过山车
|
||||
过山车 II
|
||||
闪光放大
|
||||
闪光放大 II
|
||||
降落旋转
|
||||
魔方
|
||||
魔方 II
|
||||
```
|
||||
<!-- MEDIA_EFFECT_LIST_END -->
|
||||
转场完整可用值清单，请参见 [添加视频（add_videos）](./add_videos.zh.md) 文档中的「支持的转场名称」。画面入场/出场/循环动画请参见 [添加图片（add_images）](./add_images.zh.md)。
|
||||
|
||||
##响应格式
|
||||
|
||||
|
||||
+287
-183
@@ -1,7 +1,13 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""Generate transition/animation lists for imgs_infos and video_infos docs."""
|
||||
"""Generate transition/animation lists for add_images / add_videos docs.
|
||||
|
||||
Lists belong in add_xxx docs (not xxx_infos). This script also strips any
|
||||
leftover MEDIA_EFFECT_LIST blocks from imgs_infos / video_infos and leaves
|
||||
a short pointer to the corresponding add_xxx document.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import re
|
||||
import sys
|
||||
from pathlib import Path
|
||||
|
||||
@@ -25,17 +31,6 @@ EXAMPLE_OUT = "渐隐"
|
||||
EXAMPLE_LOOP = "动感摇晃I"
|
||||
EXAMPLE_TRANSITION = "叠化"
|
||||
|
||||
OLD_EXAMPLES = {
|
||||
'"fade_in"': f'"{EXAMPLE_IN}"',
|
||||
'"fade_out"': f'"{EXAMPLE_OUT}"',
|
||||
'"bounce"': f'"{EXAMPLE_LOOP}"',
|
||||
'"cross_fade"': f'"{EXAMPLE_TRANSITION}"',
|
||||
'\\"fade_in\\"': f'\\"{EXAMPLE_IN}\\"',
|
||||
'\\"fade_out\\"': f'\\"{EXAMPLE_OUT}\\"',
|
||||
'\\"bounce\\"': f'\\"{EXAMPLE_LOOP}\\"',
|
||||
'\\"cross_fade\\"': f'\\"{EXAMPLE_TRANSITION}\\"',
|
||||
}
|
||||
|
||||
|
||||
def _sorted_titles(enum_cls) -> list[str]:
|
||||
return sorted({item.value.title for item in enum_cls}, key=lambda s: (s.casefold(), s))
|
||||
@@ -54,139 +49,125 @@ def _validate() -> tuple[list[str], list[str], list[str], list[str]]:
|
||||
bad_in = [n for n in ins if map_video_animation_name_to_enum(n, "in") is None]
|
||||
bad_out = [n for n in outs if map_video_animation_name_to_enum(n, "out") is None]
|
||||
bad_loop = [n for n in loops if map_video_animation_name_to_enum(n, "group") is None]
|
||||
bad_tr_img = []
|
||||
for name in transitions:
|
||||
matched = any(
|
||||
isinstance(attr, TransitionType) and attr.value.name == name
|
||||
for attr in TransitionType
|
||||
)
|
||||
if not matched:
|
||||
bad_tr_img.append(name)
|
||||
bad_tr_video = [n for n in transitions if find_transition_type_by_name(n) is None]
|
||||
|
||||
if bad_in or bad_out or bad_loop or bad_tr_img or bad_tr_video:
|
||||
bad_tr = [n for n in transitions if find_transition_type_by_name(n) is None]
|
||||
if bad_in or bad_out or bad_loop or bad_tr:
|
||||
raise SystemExit(
|
||||
f"unresolvable names: in={bad_in[:5]} out={bad_out[:5]} "
|
||||
f"loop={bad_loop[:5]} tr_img={bad_tr_img[:5]} tr_video={bad_tr_video[:5]}"
|
||||
f"unresolvable: in={bad_in[:3]} out={bad_out[:3]} "
|
||||
f"loop={bad_loop[:3]} tr={bad_tr[:3]}"
|
||||
)
|
||||
|
||||
for name, kind in [
|
||||
(EXAMPLE_IN, "in"),
|
||||
(EXAMPLE_OUT, "out"),
|
||||
(EXAMPLE_LOOP, "group"),
|
||||
]:
|
||||
for name, kind in [(EXAMPLE_IN, "in"), (EXAMPLE_OUT, "out"), (EXAMPLE_LOOP, "group")]:
|
||||
if map_video_animation_name_to_enum(name, kind) is None:
|
||||
raise SystemExit(f"example unresolved: {name}")
|
||||
if find_transition_type_by_name(EXAMPLE_TRANSITION) is None:
|
||||
raise SystemExit(f"example transition unresolved: {EXAMPLE_TRANSITION}")
|
||||
|
||||
return ins, outs, loops, transitions
|
||||
|
||||
|
||||
def build_zh(*, include_animations: bool, video_api_note: bool = False) -> str:
|
||||
ins, outs, loops, transitions = _validate()
|
||||
parts = [
|
||||
"### 支持的转场与动画名称",
|
||||
"",
|
||||
"下列名称可直接作为对应字段的值（与剪映端展示名一致）。未匹配到时该效果不会生效。",
|
||||
"",
|
||||
]
|
||||
if video_api_note:
|
||||
parts.extend(
|
||||
[
|
||||
"说明：`video_infos` 请求参数目前仅包含 `transition`；下列入场/出场/循环动画与图片画面动画同源，可直接用于 `imgs_infos` / `add_images` 等接口的同名字段。",
|
||||
"",
|
||||
]
|
||||
)
|
||||
parts.extend(
|
||||
def build_images_zh(ins, outs, loops, transitions) -> str:
|
||||
return "\n".join(
|
||||
[
|
||||
"### 支持的转场与动画名称",
|
||||
"",
|
||||
"下列名称可直接作为 `image_infos` 中对应字段的值（与剪映端展示名一致）。未匹配到时该效果不会生效。",
|
||||
"",
|
||||
f"#### 转场（transition，共 {len(transitions)} 种）",
|
||||
"",
|
||||
"```text",
|
||||
*transitions,
|
||||
"```",
|
||||
"",
|
||||
f"#### 入场动画（in_animation，共 {len(ins)} 种）",
|
||||
"",
|
||||
"```text",
|
||||
*ins,
|
||||
"```",
|
||||
"",
|
||||
f"#### 出场动画（out_animation，共 {len(outs)} 种）",
|
||||
"",
|
||||
"```text",
|
||||
*outs,
|
||||
"```",
|
||||
"",
|
||||
f"#### 循环动画（loop_animation，共 {len(loops)} 种）",
|
||||
"",
|
||||
"```text",
|
||||
*loops,
|
||||
"```",
|
||||
"",
|
||||
]
|
||||
)
|
||||
if include_animations:
|
||||
parts.extend(
|
||||
[
|
||||
f"#### 入场动画（in_animation，共 {len(ins)} 种）",
|
||||
"",
|
||||
"```text",
|
||||
*ins,
|
||||
"```",
|
||||
"",
|
||||
f"#### 出场动画（out_animation，共 {len(outs)} 种）",
|
||||
"",
|
||||
"```text",
|
||||
*outs,
|
||||
"```",
|
||||
"",
|
||||
f"#### 循环动画（loop_animation，共 {len(loops)} 种）",
|
||||
"",
|
||||
"```text",
|
||||
*loops,
|
||||
"```",
|
||||
"",
|
||||
]
|
||||
)
|
||||
return "\n".join(parts)
|
||||
|
||||
|
||||
def build_en(*, include_animations: bool, video_api_note: bool = False) -> str:
|
||||
ins, outs, loops, transitions = _validate()
|
||||
parts = [
|
||||
"### Supported Transitions and Animations",
|
||||
"",
|
||||
"Use the names below directly as field values (same as CapCut/Jianying display names). Unmatched names are ignored.",
|
||||
"",
|
||||
]
|
||||
if video_api_note:
|
||||
parts.extend(
|
||||
[
|
||||
"Note: `video_infos` currently only accepts `transition` in the request. "
|
||||
"Intro/outro/loop names below match image/clip animations and can be used with `imgs_infos` / `add_images`.",
|
||||
"",
|
||||
]
|
||||
)
|
||||
parts.extend(
|
||||
def build_images_en(ins, outs, loops, transitions) -> str:
|
||||
return "\n".join(
|
||||
[
|
||||
"### Supported Transitions and Animations",
|
||||
"",
|
||||
"Use the names below directly as `image_infos` field values (same as CapCut/Jianying display names). Unmatched names are ignored.",
|
||||
"",
|
||||
f"#### Transitions (transition, {len(transitions)} total)",
|
||||
"",
|
||||
"```text",
|
||||
*transitions,
|
||||
"```",
|
||||
"",
|
||||
f"#### Intro animations (in_animation, {len(ins)} total)",
|
||||
"",
|
||||
"```text",
|
||||
*ins,
|
||||
"```",
|
||||
"",
|
||||
f"#### Outro animations (out_animation, {len(outs)} total)",
|
||||
"",
|
||||
"```text",
|
||||
*outs,
|
||||
"```",
|
||||
"",
|
||||
f"#### Loop animations (loop_animation, {len(loops)} total)",
|
||||
"",
|
||||
"```text",
|
||||
*loops,
|
||||
"```",
|
||||
"",
|
||||
]
|
||||
)
|
||||
|
||||
|
||||
def build_videos_zh(transitions) -> str:
|
||||
return "\n".join(
|
||||
[
|
||||
"### 支持的转场名称（transition 可用值）",
|
||||
"",
|
||||
"下列名称可直接作为 `video_infos` 中 `transition` 的值（与剪映端展示名一致）。未匹配到时该转场不会生效。",
|
||||
"",
|
||||
f"当前共 **{len(transitions)}** 种转场：",
|
||||
"",
|
||||
"```text",
|
||||
*transitions,
|
||||
"```",
|
||||
"",
|
||||
]
|
||||
)
|
||||
if include_animations:
|
||||
parts.extend(
|
||||
[
|
||||
f"#### Intro animations (in_animation, {len(ins)} total)",
|
||||
"",
|
||||
"```text",
|
||||
*ins,
|
||||
"```",
|
||||
"",
|
||||
f"#### Outro animations (out_animation, {len(outs)} total)",
|
||||
"",
|
||||
"```text",
|
||||
*outs,
|
||||
"```",
|
||||
"",
|
||||
f"#### Loop animations (loop_animation, {len(loops)} total)",
|
||||
"",
|
||||
"```text",
|
||||
*loops,
|
||||
"```",
|
||||
"",
|
||||
]
|
||||
)
|
||||
return "\n".join(parts)
|
||||
|
||||
|
||||
def inject(path: Path, before_heading: str, block: str) -> None:
|
||||
def build_videos_en(transitions) -> str:
|
||||
return "\n".join(
|
||||
[
|
||||
"### Supported Transition Names (`transition` values)",
|
||||
"",
|
||||
"Use the names below directly as `video_infos.transition` (same as CapCut/Jianying display names). Unmatched names are ignored.",
|
||||
"",
|
||||
f"Total: **{len(transitions)}** transitions:",
|
||||
"",
|
||||
"```text",
|
||||
*transitions,
|
||||
"```",
|
||||
"",
|
||||
]
|
||||
)
|
||||
|
||||
|
||||
def inject(path: Path, before: str, block: str) -> None:
|
||||
text = path.read_text(encoding="utf-8")
|
||||
wrapped = f"{MARKER_START}\n{block.rstrip()}\n{MARKER_END}\n\n"
|
||||
|
||||
@@ -196,112 +177,235 @@ def inject(path: Path, before_heading: str, block: str) -> None:
|
||||
after = text[end:].lstrip("\n")
|
||||
text = text[:start] + wrapped.rstrip("\n") + "\n\n" + after
|
||||
else:
|
||||
if before_heading not in text:
|
||||
raise SystemExit(f"insert marker not found in {path}: {before_heading}")
|
||||
text = text.replace(before_heading, wrapped + before_heading, 1)
|
||||
|
||||
for old, new in OLD_EXAMPLES.items():
|
||||
text = text.replace(old, new)
|
||||
if before not in text:
|
||||
raise SystemExit(f"insert marker not found in {path}: {before}")
|
||||
text = text.replace(before, wrapped + before, 1)
|
||||
|
||||
path.write_text(text, encoding="utf-8")
|
||||
|
||||
|
||||
def update_param_hints(path: Path, lang: str, has_animations: bool) -> None:
|
||||
def strip_list_keep_pointer(path: Path, pointer: str) -> None:
|
||||
"""Remove MEDIA_EFFECT_LIST from infos docs and insert a short pointer."""
|
||||
text = path.read_text(encoding="utf-8")
|
||||
if MARKER_START in text and MARKER_END in text:
|
||||
start = text.index(MARKER_START)
|
||||
end = text.index(MARKER_END) + len(MARKER_END)
|
||||
after = text[end:].lstrip("\n")
|
||||
text = text[:start] + pointer.rstrip() + "\n\n" + after
|
||||
path.write_text(text, encoding="utf-8")
|
||||
|
||||
|
||||
def update_add_images_hints(path: Path, lang: str) -> None:
|
||||
text = path.read_text(encoding="utf-8")
|
||||
if lang == "zh":
|
||||
text = text.replace(
|
||||
"| transition | string |❌ | None |转场效果 |",
|
||||
"| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |",
|
||||
"| in_animation | string | ❌ | - | 入场动画名称（可选） |",
|
||||
"| in_animation | string | ❌ | - | 入场动画名称，须为下方「入场动画」列表中的值 |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| transition | string |❌ | None |转场效果 |",
|
||||
"| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |",
|
||||
"| out_animation | string | ❌ | - | 出场动画名称（可选） |",
|
||||
"| out_animation | string | ❌ | - | 出场动画名称，须为下方「出场动画」列表中的值 |",
|
||||
)
|
||||
# video_infos table may differ slightly
|
||||
text = text.replace(
|
||||
"| transition | string |❌ | None |转场效果 |",
|
||||
"| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |",
|
||||
"| loop_animation | string | ❌ | - | 循环动画名称（可选） |",
|
||||
"| loop_animation | string | ❌ | - | 循环动画名称，须为下方「循环动画」列表中的值 |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| transition | string | ❌ | - | 转场效果名称（可选） |",
|
||||
"| transition | string | ❌ | - | 转场名称，须为下方「转场」列表中的值 |",
|
||||
)
|
||||
if has_animations:
|
||||
text = text.replace(
|
||||
"| in_animation | string |❌ | None |入动画效果 |",
|
||||
"| in_animation | string |❌ | None |入场动画名称，须为下方「入场动画」列表中的值 |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| out_animation | string |❌ | None |出动画效果 |",
|
||||
"| out_animation | string |❌ | None |出场动画名称，须为下方「出场动画」列表中的值 |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| loop_animation | string |❌ | None |循动画效果 |",
|
||||
"| loop_animation | string |❌ | None |循环动画名称，须为下方「循环动画」列表中的值 |",
|
||||
)
|
||||
else:
|
||||
text = text.replace(
|
||||
"| transition | string |❌ | None | Transition effect |",
|
||||
"| transition | string |❌ | None | Transition name from Transitions below |",
|
||||
"| in_animation | string | ❌ | - | Intro animation name (optional) |",
|
||||
"| in_animation | string | ❌ | - | Intro animation name from Intro animations below |",
|
||||
)
|
||||
if has_animations:
|
||||
text = text.replace(
|
||||
"| in_animation | string |❌ | None | Entrance animation effect |",
|
||||
"| in_animation | string |❌ | None | Intro animation name from Intro animations below |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| out_animation | string |❌ | None | Exit animation effect |",
|
||||
"| out_animation | string |❌ | None | Outro animation name from Outro animations below |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| loop_animation | string |❌ | None | Loop animation effect |",
|
||||
"| loop_animation | string |❌ | None | Loop animation name from Loop animations below |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| out_animation | string | ❌ | - | Outro animation name (optional) |",
|
||||
"| out_animation | string | ❌ | - | Outro animation name from Outro animations below |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| loop_animation | string | ❌ | - | Loop animation name (optional) |",
|
||||
"| loop_animation | string | ❌ | - | Loop animation name from Loop animations below |",
|
||||
)
|
||||
text = text.replace(
|
||||
"| transition | string | ❌ | - | Transition effect name (optional) |",
|
||||
"| transition | string | ❌ | - | Transition name from Transitions below |",
|
||||
)
|
||||
path.write_text(text, encoding="utf-8")
|
||||
|
||||
|
||||
def update_add_videos_hints(path: Path, lang: str) -> None:
|
||||
text = path.read_text(encoding="utf-8")
|
||||
if lang == "zh":
|
||||
text = text.replace(
|
||||
"| transition | string | ❌ | - | 转场效果名称 |",
|
||||
"| transition | string | ❌ | - | 转场名称，须为下方「支持的转场名称」列表中的值 |",
|
||||
)
|
||||
# Replace invalid transition examples
|
||||
text = text.replace('\\"淡入淡出\\"', f'\\"{EXAMPLE_TRANSITION}\\"')
|
||||
text = text.replace('"淡入淡出"', f'"{EXAMPLE_TRANSITION}"')
|
||||
# Shorten vague transition section if present
|
||||
text = re.sub(
|
||||
r"#### 转场效果\n\n- \*\*transition\*\*: 转场效果名称\n- \*\*transition_duration\*\*: 转场持续时间\n"
|
||||
r" - 最小值：100,000微秒（0\.1秒）\n"
|
||||
r" - 最大值：2,500,000微秒（2\.5秒）\n"
|
||||
r" - 推荐值：500,000微秒（0\.5秒）\n",
|
||||
"#### 转场效果\n\n"
|
||||
"- **transition**: 转场名称，须为下方「支持的转场名称」列表中的值\n"
|
||||
"- **transition_duration**: 转场持续时间\n"
|
||||
" - 最小值：100,000微秒（0.1秒）\n"
|
||||
" - 最大值：2,500,000微秒（2.5秒）\n"
|
||||
" - 推荐值：500,000微秒（0.5秒）\n",
|
||||
text,
|
||||
count=1,
|
||||
)
|
||||
else:
|
||||
text = text.replace(
|
||||
"| transition | string | ❌ | - | Transition effect name |",
|
||||
"| transition | string | ❌ | - | Transition name from Supported Transition Names below |",
|
||||
)
|
||||
text = text.replace('\\"fade\\"', f'\\"{EXAMPLE_TRANSITION}\\"')
|
||||
text = text.replace('"fade"', f'"{EXAMPLE_TRANSITION}"')
|
||||
text = text.replace('\\"淡入淡出\\"', f'\\"{EXAMPLE_TRANSITION}\\"')
|
||||
text = text.replace('"淡入淡出"', f'"{EXAMPLE_TRANSITION}"')
|
||||
path.write_text(text, encoding="utf-8")
|
||||
|
||||
|
||||
def update_infos_examples(path: Path) -> None:
|
||||
"""Keep infos docs examples valid, without embedding full lists."""
|
||||
text = path.read_text(encoding="utf-8")
|
||||
text = text.replace('\\"淡入淡出\\"', f'\\"{EXAMPLE_TRANSITION}\\"')
|
||||
text = text.replace('"淡入淡出"', f'"{EXAMPLE_TRANSITION}"')
|
||||
text = text.replace('\\"fade\\"', f'\\"{EXAMPLE_TRANSITION}\\"')
|
||||
text = text.replace('"fade"', f'"{EXAMPLE_TRANSITION}"')
|
||||
text = text.replace('\\"cross_fade\\"', f'\\"{EXAMPLE_TRANSITION}\\"')
|
||||
text = text.replace('"cross_fade"', f'"{EXAMPLE_TRANSITION}"')
|
||||
text = text.replace('\\"fade_in\\"', f'\\"{EXAMPLE_IN}\\"')
|
||||
text = text.replace('"fade_in"', f'"{EXAMPLE_IN}"')
|
||||
text = text.replace('\\"fade_out\\"', f'\\"{EXAMPLE_OUT}\\"')
|
||||
text = text.replace('"fade_out"', f'"{EXAMPLE_OUT}"')
|
||||
text = text.replace('\\"bounce\\"', f'\\"{EXAMPLE_LOOP}\\"')
|
||||
text = text.replace('"bounce"', f'"{EXAMPLE_LOOP}"')
|
||||
path.write_text(text, encoding="utf-8")
|
||||
|
||||
|
||||
def main() -> None:
|
||||
docs = ROOT / "docs"
|
||||
ins, outs, loops, transitions = _validate()
|
||||
|
||||
# imgs_infos: transitions + animations
|
||||
inject(docs / "imgs_infos.zh.md", "##响应格式", build_zh(include_animations=True))
|
||||
inject(docs / "imgs_infos.md", "## Response Format", build_en(include_animations=True))
|
||||
update_param_hints(docs / "imgs_infos.zh.md", "zh", True)
|
||||
update_param_hints(docs / "imgs_infos.md", "en", True)
|
||||
# --- add_images ---
|
||||
inject(docs / "add_images.zh.md", "## 响应格式", build_images_zh(ins, outs, loops, transitions))
|
||||
inject(docs / "add_images.md", "## Response Format", build_images_en(ins, outs, loops, transitions))
|
||||
update_add_images_hints(docs / "add_images.zh.md", "zh")
|
||||
update_add_images_hints(docs / "add_images.md", "en")
|
||||
|
||||
# video_infos: full lists (transition is the request field; animations listed for the same media catalog)
|
||||
inject(
|
||||
# --- add_videos ---
|
||||
inject(docs / "add_videos.zh.md", "## 响应格式", build_videos_zh(transitions))
|
||||
# EN may use "## Response Format" after transition section
|
||||
inject(docs / "add_videos.md", "## Response Format", build_videos_en(transitions))
|
||||
update_add_videos_hints(docs / "add_videos.zh.md", "zh")
|
||||
update_add_videos_hints(docs / "add_videos.md", "en")
|
||||
|
||||
# --- strip from infos docs, leave pointers ---
|
||||
strip_list_keep_pointer(
|
||||
docs / "imgs_infos.zh.md",
|
||||
"### 可用转场与动画名称\n\n"
|
||||
"转场、入场/出场/循环动画的完整可用值清单，请参见 "
|
||||
"[添加图片（add_images）](./add_images.zh.md) 文档中的「支持的转场与动画名称」。",
|
||||
)
|
||||
strip_list_keep_pointer(
|
||||
docs / "imgs_infos.md",
|
||||
"### Available Transitions and Animations\n\n"
|
||||
"For the full lists of valid `transition` / `in_animation` / `out_animation` / `loop_animation` values, "
|
||||
"see [add_images](./add_images.md) → Supported Transitions and Animations.",
|
||||
)
|
||||
strip_list_keep_pointer(
|
||||
docs / "video_infos.zh.md",
|
||||
"##响应格式",
|
||||
build_zh(include_animations=True, video_api_note=True),
|
||||
"### 可用转场名称\n\n"
|
||||
"转场完整可用值清单，请参见 [添加视频（add_videos）](./add_videos.zh.md) 文档中的「支持的转场名称」。"
|
||||
"画面入场/出场/循环动画请参见 [添加图片（add_images）](./add_images.zh.md)。",
|
||||
)
|
||||
inject(
|
||||
strip_list_keep_pointer(
|
||||
docs / "video_infos.md",
|
||||
"## Response Format",
|
||||
build_en(include_animations=True, video_api_note=True),
|
||||
"### Available Transition Names\n\n"
|
||||
"For the full list of valid `transition` values, see [add_videos](./add_videos.md) → Supported Transition Names. "
|
||||
"For intro/outro/loop clip animations, see [add_images](./add_images.md).",
|
||||
)
|
||||
update_param_hints(docs / "video_infos.zh.md", "zh", False)
|
||||
update_param_hints(docs / "video_infos.md", "en", False)
|
||||
|
||||
for path, old, new in [
|
||||
for name in ("imgs_infos.zh.md", "imgs_infos.md", "video_infos.zh.md", "video_infos.md"):
|
||||
update_infos_examples(docs / name)
|
||||
|
||||
# Restore infos param hints that previously pointed to "下方列表"
|
||||
for path, replacements in [
|
||||
(
|
||||
docs / "imgs_infos.zh.md",
|
||||
[
|
||||
(
|
||||
"| in_animation | string |❌ | None |入场动画名称，须为下方「入场动画」列表中的值 |",
|
||||
"| in_animation | string |❌ | None |入场动画名称，可用值见 [add_images](./add_images.zh.md) |",
|
||||
),
|
||||
(
|
||||
"| out_animation | string |❌ | None |出场动画名称，须为下方「出场动画」列表中的值 |",
|
||||
"| out_animation | string |❌ | None |出场动画名称，可用值见 [add_images](./add_images.zh.md) |",
|
||||
),
|
||||
(
|
||||
"| loop_animation | string |❌ | None |循环动画名称，须为下方「循环动画」列表中的值 |",
|
||||
"| loop_animation | string |❌ | None |循环动画名称，可用值见 [add_images](./add_images.zh.md) |",
|
||||
),
|
||||
(
|
||||
"| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |",
|
||||
"| transition | string |❌ | None |转场名称，可用值见 [add_images](./add_images.zh.md) / [add_videos](./add_videos.zh.md) |",
|
||||
),
|
||||
],
|
||||
),
|
||||
(
|
||||
docs / "imgs_infos.md",
|
||||
[
|
||||
(
|
||||
"| in_animation | string |❌ | None | Intro animation name from Intro animations below |",
|
||||
"| in_animation | string |❌ | None | Intro animation name; see [add_images](./add_images.md) |",
|
||||
),
|
||||
(
|
||||
"| out_animation | string |❌ | None | Outro animation name from Outro animations below |",
|
||||
"| out_animation | string |❌ | None | Outro animation name; see [add_images](./add_images.md) |",
|
||||
),
|
||||
(
|
||||
"| loop_animation | string |❌ | None | Loop animation name from Loop animations below |",
|
||||
"| loop_animation | string |❌ | None | Loop animation name; see [add_images](./add_images.md) |",
|
||||
),
|
||||
(
|
||||
"| transition | string |❌ | None | Transition name from Transitions below |",
|
||||
"| transition | string |❌ | None | Transition name; see [add_images](./add_images.md) / [add_videos](./add_videos.md) |",
|
||||
),
|
||||
],
|
||||
),
|
||||
(
|
||||
docs / "video_infos.zh.md",
|
||||
"| transition | string |❌ | None |转场效果 |",
|
||||
"| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |",
|
||||
[
|
||||
(
|
||||
"| transition | string |❌ | None |转场名称，须为下方「转场」列表中的值 |",
|
||||
"| transition | string |❌ | None |转场名称，可用值见 [add_videos](./add_videos.zh.md) |",
|
||||
),
|
||||
],
|
||||
),
|
||||
(
|
||||
docs / "video_infos.md",
|
||||
"| transition | string |❌ | None | Transition effect |",
|
||||
"| transition | string |❌ | None | Transition name from Transitions below |",
|
||||
[
|
||||
(
|
||||
"| transition | string |❌ | None | Transition name from Transitions below |",
|
||||
"| transition | string |❌ | None | Transition name; see [add_videos](./add_videos.md) |",
|
||||
),
|
||||
],
|
||||
),
|
||||
]:
|
||||
text = path.read_text(encoding="utf-8")
|
||||
if old in text:
|
||||
path.write_text(text.replace(old, new), encoding="utf-8")
|
||||
for old, new in replacements:
|
||||
text = text.replace(old, new)
|
||||
path.write_text(text, encoding="utf-8")
|
||||
|
||||
_, _, _, transitions = _validate()
|
||||
print(
|
||||
f"updated imgs/video infos docs: "
|
||||
f"transitions={len(transitions)}, "
|
||||
f"in={len(_sorted_titles(IntroType))}, "
|
||||
f"out={len(_sorted_titles(OutroType))}, "
|
||||
f"loop={len(_sorted_titles(GroupAnimationType))}"
|
||||
"moved media effect lists to add_images/add_videos; "
|
||||
f"transitions={len(transitions)}, in={len(ins)}, out={len(outs)}, loop={len(loops)}"
|
||||
)
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user