Stream - Workers の Media Transformations バインディング

公開日: 2026-03-18 カテゴリ: Stream

Cloudflare の Media Transformations バインディングを Workers で使用できるようになりました。これにより、R2 バケットなどのプライベートな場所に保存された動画でも、リサイズ、クロップ、フレーム抽出、オーディオ抽出といった変換が可能になります。

主な利用シーン

• プライベートまたは保護されたソースに保存された動画の変換
• 動画を最適化して、出力を R2 に直接保存して再利用
• Workers AI と組み合わせて、分類や説明のために静止フレームを抽出
• Workers AI を使った文字起こしのためにオーディオトラックを抽出

始め方

まず、Wrangler の設定に Media バインディングを追加します。

wrangler.jsonc の例:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "media": {
    "binding": "MEDIA"
  }
}

wrangler.toml の例:

[media]
binding = "MEDIA"

その後、Worker 内でバインディングを使って動画を変換します。

JavaScript 例

export default {
  async fetch(request, env) {
    const video = await env.R2_BUCKET.get("input.mp4");
    const result = env.MEDIA.input(video.body)
      .transform({ width: 480, height: 270 })
      .output({ mode: "video", duration: "5s" });
    return await result.response();
  },
};

TypeScript 例

export default {
  async fetch(request, env) {
    const video = await env.R2_BUCKET.get("input.mp4");
    const result = env.MEDIA.input(video.body)
      .transform({ width: 480, height: 270 })
      .output({ mode: "video", duration: "5s" });
    return await result.response();
  },
};

出力モード

• video — 最適化された MP4 クリップ
• frame — 静止画像
• spritesheet — 複数フレームのスプライトシート
• audio — M4A の抽出

詳細は Media Transformations binding documentation を参照してください。