mcpField
B
blitzreels-motion-graphics

blitzreels-motion-graphics

github.com/blitzreels创意与媒体442 次安装6 周前更新
代码仓库

关于 blitzreels-motion-graphics

通过 BlitzReels Playground API 创建和编辑动态图形作品的技能，使用 JSON 规格与脚本管理动画元素、时间线叠加层，并导出作品。

主要功能

  1. 01浏览作品预设
  2. 02创建和编辑作品
  3. 03为文字、图形、媒体和图表添加动画
  4. 04管理时间线叠加层和字幕
  5. 05导出作品

适用场景

  1. 01制作动画标题卡
  2. 02创建包含图表和视频的作品
  3. 03修改现有作品中的元素
  4. 04为视频项目添加字幕或叠加层

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/blitzreels/agent-skills --skill blitzreels-motion-graphics

安装后在 Claude Code 中输入/blitzreels-motion-graphics确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

examples/
create-composition.md
references/
composition-spec.md
scripts/
blitzreels.sh
playground.sh

详细介绍

BlitzReels 动态图形（Playground API）

通过 Playground API 创建和编辑动态图形合成。使用文本、形状、图片、视频、图表、代码块等构建动画场景。

快速开始

# List available presets
bash scripts/playground.sh list-presets PROJECT_ID

# Create a composition from a JSON file
bash scripts/playground.sh create PROJECT_ID spec.json

# Create from inline JSON
bash scripts/playground.sh create PROJECT_ID '{"name":"Title Card","fps":30,"width":1920,"height":1080,"durationInFrames":90,"mode":"elements","elements":[{"id":"title","type":"text","content":"Hello World","style":{"fontSize":96,"fontWeight":"bold","color":"#fff","display":"flex","justifyContent":"center","alignItems":"center"}}]}'

# Get, update, delete
bash scripts/playground.sh get PROJECT_ID COMP_ID
bash scripts/playground.sh update PROJECT_ID COMP_ID updated-spec.json
bash scripts/playground.sh delete PROJECT_ID COMP_ID

# Export the project
bash scripts/playground.sh export PROJECT_ID --resolution 1080p

工作流

  1. 创建项目（或使用现有项目）
  2. 浏览预设 — playground.sh list-presets 获取灵感
  3. 构建合成规范 — 使用 JSON 描述画布、元素和动画
  4. 创建合成 — playground.sh create
  5. 迭代 — 更新元素、调整时间、添加动画
  6. 导出 — playground.sh export

脚本

scripts/playground.sh

专为 Playground 合成打造的 CRUD 封装工具。

命令用法
list-presetsplayground.sh list-presets <projectId>
listplayground.sh list <projectId>
createplayground.sh create <projectId> <spec.json|-|JSON>
getplayground.sh get <projectId> <compositionId>
updateplayground.sh update <projectId> <compositionId> <spec>
deleteplayground.sh delete <projectId> <compositionId>
exportplayground.sh export <projectId> [--resolution 1080p]

运行 bash scripts/playground.sh --help 查看完整用法。

scripts/blitzreels.sh

用于临时调用的通用 API 助手。

环境变量

变量必需描述
BLITZREELS_API_KEY是API 密钥
BLITZREELS_API_BASE_URL否覆盖基础 URL
BLITZREELS_ALLOW_EXPENSIVE否通过 blitzreels.sh 发起导出请求时设为 1

API 端点

Playground 合成
方法路径描述
GET/projects/{id}/playground/presets列出预设模板
GET/projects/{id}/playground/compositions列出合成
POST/projects/{id}/playground/compositions创建合成
GET/projects/{id}/playground/compositions/{cid}获取合成
PATCH/projects/{id}/playground/compositions/{cid}更新合成
DELETE/projects/{id}/playground/compositions/{cid}删除合成
元素级操作
方法路径描述
PATCH/projects/{id}/playground/compositions/{cid}/elements/{eid}更新单个元素
DELETE/projects/{id}/playground/compositions/{cid}/elements/{eid}删除元素
项目操作
方法路径描述
POST/projects创建项目
POST/projects/{id}/export开始导出（开销较大）
GET/exports/{export_id}获取导出状态和下载 URL

合成规范

合成 JSON 规范定义了画布、元素和动画。完整架构请参阅 references/composition-spec.md。

最简示例
{
  "name": "Title Card",
  "fps": 30,
  "width": 1920,
  "height": 1080,
  "durationInFrames": 150,
  "background": "#1a1a2e",
  "mode": "elements",
  "elements": [
    {
      "id": "title",
      "type": "text",
      "content": "Hello World",
      "from": 0,
      "durationInFrames": 150,
      "style": {
        "fontSize": 96,
        "fontWeight": "bold",
        "color": "#ffffff",
        "opacity": {
          "keyframes": [
            { "frame": 0, "value": 0 },
            { "frame": 30, "value": 1 }
          ]
        }
      }
    }
  ]
}
元素类型
类型描述
text支持打字机和高亮效果的文本
shape矩形、圆形、椭圆、直线、箭头、多边形、星形
image静态图片，可选 Ken Burns 效果
video视频片段，支持音量、循环和播放控制
audio音轨
chart条形图、饼图、折线图、面积图、环形图，支持动画显示
code带语法高亮的代码，支持逐行显示
svg支持路径绘制／变形动画的 SVG
group子元素容器（并行或顺序播放）
lottie来自 JSON 或 URL 的 Lottie 动画
动画选项
  • 静态值："opacity": 1
  • 关键帧：逐帧动画，带缓动
  • 弹簧物理效果：smooth、snappy、bouncy、heavy、gentle 预设
  • 缓动：linear、easeIn、easeOut、easeInOut、弹性、弹跳、贝塞尔
场景转场（scenes mode）

fade、slide、wipe、flip、clockWipe — 支持方向变体。

时间线与叠加层编辑

要编辑现有视频项目（而非创作区合成），请使用以下端点：

方法路径描述
GET/projects/{id}/context?mode=timeline获取项目时间线
POST/projects/{id}/overlays添加文本/图像叠加层
PATCH/projects/{id}/overlays/{oid}更新叠加层
DELETE/projects/{id}/overlays/{oid}移除叠加层
POST/projects/{id}/captions添加/更新字幕
PATCH/projects/{id}/captions/style更新字幕样式

参考资料

  • references/composition-spec.md — 完整的合成 JSON 架构、元素类型、动画格式、弹簧预设和转场

注意事项

  • 请使用 https://www.blitzreels.com/api/v1 作为基础 URL。https://blitzreels.com 会重定向到 www，部分 HTTP 客户端会在重定向时丢弃 Authorization 标头。
  • 添加动画时，尽量用最少数量的关键帧来表达动作（减少抖动）。
  • 完整的 OpenAPI 规范：https://www.blitzreels.com/api/openapi.json

速率限制

计划请求数/分钟
免费版10
Creator30
Pro60
Agency120

评论

支持 Markdown