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