blitzreels-motion-graphics

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-presets	playground.sh list-presets <projectId>
list	playground.sh list <projectId>
create	playground.sh create <projectId> <spec.json|-|JSON>
get	playground.sh get <projectId> <compositionId>
update	playground.sh update <projectId> <compositionId> <spec>
delete	playground.sh delete <projectId> <compositionId>
export	playground.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、elastic、bounce、bezier

シーン遷移（scenes モード）

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 スキーマ、要素の種類、アニメーション形式、スプリングプリセット、トランジションの詳細

注意事項

• ベース URL には https://www.blitzreels.com/api/v1 を使用してください。https://blitzreels.com は www にリダイレクトされ、一部の HTTP クライアントではリダイレクト時に Authorization ヘッダーが削除されます。
• アニメーションでは、動きを伝えるために必要な最小限のキーフレームを使用してください（ジッターを軽減できます）。
• OpenAPI 仕様の全文：https://www.blitzreels.com/api/openapi.json

レート制限

プラン	リクエスト／分
Free	10
Creator	30
Pro	60
Agency	120