用途:通过 BlitzReels Playground API 创建和编辑动态图形合成,用 JSON 规格描述画布、元素与动画,适合程序化生成标题卡、数据可视化动画、代码演示等场景。
主要能力:元素类型包括 text(打字机、高亮)、shape(矩形、圆、椭圆、线、箭头、多边形、星形)、image(可选 Ken Burns)、video、audio、chart(柱状、饼、折线、面积、环形,带动画揭示)、code(语法高亮逐行显示)、svg(路径绘制/变形)、group(并行或串行容器)、lottie。动画支持静态值、关键帧、弹簧物理(smooth、snappy、bouncy、heavy、gentle)与缓动(linear、easeIn、easeOut、easeInOut、elastic、bounce、bezier);scenes 模式支持 fade、slide、wipe、flip、clockWipe 转场。另提供时间线与叠加编辑接口,用于已有视频项目。
使用方式:需设置环境变量 BLITZREELS_API_KEY,可选 BLITZREELS_API_BASE_URL;导出经 blitzreels.sh 时需设 BLITZREELS_ALLOW_EXPENSIVE=1。基础 URL 用 https://www.blitzreels.com/api/v1。常用命令:bash scripts/playground.sh list-presets PROJECT_ID;bash scripts/playground.sh create PROJECT_ID spec.json;bash scripts/playground.sh get/update/delete PROJECT_ID COMP_ID;bash scripts/playground.sh export PROJECT_ID --resolution 1080p。工作流为创建项目、浏览预设、编写 JSON 规格、创建合成、迭代、导出。
限制:导出为高开销操作;速率限制按套餐为 Free 10、Creator 30、Pro 60、Agency 120 请求/分钟;动画建议用最少关键帧以减少抖动。完整规格见 references/composition-spec.md,OpenAPI 见 https://www.blitzreels.com/api/openapi.json。