BlitzReels Motion Graphics (Playground API)

BlitzReels Motion Graphics (Playground API)

Create and edit motion graphics compositions via the Playground API. Build animated scenes with text, shapes, images, video, charts, code blocks, and more.

Quick Start

# 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

Workflow

1. Create a project (or use an existing one)
2. Browse presets — playground.sh list-presets for inspiration
3. Build composition spec — JSON describing canvas, elements, and animations
4. Create composition — playground.sh create
5. Iterate — Update elements, adjust timing, add animations
6. Export — playground.sh export

Scripts

scripts/​playground.sh

Purpose-built CRUD wrapper for playground compositions.

Run bash scripts/​playground.sh --help for full usage.

scripts/​blitzreels.sh

Generic API helper for ad-hoc calls.

Environment Variables

API Endpoints

Playground Compositions

Element-Level Operations

Project Operations

Composition Spec

The composition JSON spec defines the canvas, elements, and animations. See references/​composition-spec.md for the full schema.

Minimal Example

{
  "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 }
          ]
        }
      }
    }
  ]
}

Element Types

Animation Options

• Static values: "opacity": 1
• Keyframes: Frame-by-frame with easing
• Spring physics: smooth, snappy, bouncy, heavy, gentle presets
• Easing: linear, easeIn, easeOut, easeInOut, elastic, bounce, bezier

Scene Transitions (scenes mode)

fade, slide, wipe, flip, clockWipe — with directional variants.

Timeline & Overlay Editing

For editing existing video projects (not playground compositions), use these endpoints:

References

• references/​composition-spec.md — Full composition JSON schema, element types, animation format, spring presets, transitions

Notes

• Use https://www.blitzreels.com/​api/​v1 as your base URL. https://blitzreels.com redirects to www, and some HTTP clients drop the Authorization header on redirects.
• When animating, prefer the smallest number of keyframes that communicates the motion (reduces jitter).
• Full OpenAPI spec: https://www.blitzreels.com/​api/​openapi.json

Rate Limits