Transloadit メディア処理

Transloadit のクラウドインフラストラクチャを使用してメディアファイルを処理、変換、エンコードします。 ビデオ、オーディオ、画像、ドキュメントに対応した 86 以上の専門的な処理ロボットをサポートしています。

このスキルを使用する場合

以下が必要な場合にこのスキルを使用してください:

• ビデオを HLS、MP4、WebM などの形式にエンコードする
• ビデオからサムネイルやアニメーション GIF を生成する
• 画像をリサイズ、クロップ、ウォーターマーク、または最適化する
• 画像形式間の変換 (JPEG、PNG、WebP、AVIF、HEIF)
• オーディオを抽出またはトランスコード (MP3、AAC、FLAC、WAV)
• ビデオまたはオーディオクリップを連結する
• ビデオにサブタイトルまたはテキストオーバーレイを追加する
• ドキュメント OCR (PDF、スキャン済み画像)
• 音声テキスト変換またはテキスト音声変換を実行する
• AI ベースのコンテンツモデレーションまたはオブジェクト検出を適用する
• 複数のステップで操作をチェーンしたメディアパイプラインを構築する

セットアップ

オプション A: MCP サーバー (Copilot 推奨)

Transloadit MCP サーバーを IDE 設定に追加します。これにより、エージェントは Transloadit ツール (create_template、create_assembly、list_assembly_notifications など) に直接アクセスできます。

VS Code / GitHub Copilot (.vscode/mcp.json またはユーザー設定):

{
  "servers": {
    "transloadit": {
      "command": "npx",
      "args": ["-y", "@transloadit/mcp-server", "stdio"],
      "env": {
        "TRANSLOADIT_KEY": "YOUR_AUTH_KEY",
        "TRANSLOADIT_SECRET": "YOUR_AUTH_SECRET"
      }
    }
  }
}

API 認証情報は https://transloadit.com/c/-/api-credentials で取得してください。

オプション B: CLI

コマンドを直接実行する場合:

npx -y @transloadit/node assemblies create \
  --steps '{"encoded": {"robot": "/video/encode", "use": ":original", "preset": "hls-1080p"}}' \
  --wait \
  --input ./my-video.mp4

コアワークフロー

ビデオを HLS にエンコード (適応型ストリーミング)

{
  "steps": {
    "encoded": {
      "robot": "/video/encode",
      "use": ":original",
      "preset": "hls-1080p"
    }
  }
}

ビデオからサムネイルを生成

{
  "steps": {
    "thumbnails": {
      "robot": "/video/thumbs",
      "use": ":original",
      "count": 8,
      "width": 320,
      "height": 240
    }
  }
}

画像をリサイズしてウォーターマークを追加

{
  "steps": {
    "resized": {
      "robot": "/image/resize",
      "use": ":original",
      "width": 1200,
      "height": 800,
      "resize_strategy": "fit"
    },
    "watermarked": {
      "robot": "/image/resize",
      "use": "resized",
      "watermark_url": "https://example.com/logo.png",
      "watermark_position": "bottom-right",
      "watermark_size": "15%"
    }
  }
}

ドキュメントを OCR

{
  "steps": {
    "recognized": {
      "robot": "/document/ocr",
      "use": ":original",
      "provider": "aws",
      "format": "text"
    }
  }
}

オーディオクリップを連結

{
  "steps": {
    "imported": {
      "robot": "/http/import",
      "url": ["https://example.com/clip1.mp3", "https://example.com/clip2.mp3"]
    },
    "concatenated": {
      "robot": "/audio/concat",
      "use": "imported",
      "preset": "mp3"
    }
  }
}

マルチステップパイプライン

ステップは "use" フィールドを使用してチェーンできます。各ステップは前のステップの出力を参照します:

{
  "steps": {
    "resized": {
      "robot": "/image/resize",
      "use": ":original",
      "width": 1920
    },
    "optimized": {
      "robot": "/image/optimize",
      "use": "resized"
    },
    "exported": {
      "robot": "/s3/store",
      "use": "optimized",
      "bucket": "my-bucket",
      "path": "processed/${file.name}"
    }
  }
}

主要な概念

• Assembly: 単一の処理ジョブ。create_assembly (MCP) または assemblies create (CLI) で作成します。
• Template: Transloadit に保存されたステップの再利用可能なセット。create_template (MCP) または templates create (CLI) で作成します。
• Robot: 処理ユニット (例: /video/encode、/image/resize)。完全なリストは https://transloadit.com/docs/transcoding/ を参照してください。
• Steps: パイプラインを定義する JSON オブジェクト。各キーはステップ名で、各値がロボットを設定します。
• :original: アップロードされた入力ファイルを参照します。

ヒント

• CLI で --wait を使用すると、処理が完了するまでブロックします。
• すべてのパラメーターを指定する代わりに、preset 値 (例: "hls-1080p"、"mp3"、"webp") を使用して共通のフォーマットターゲットを指定します。
• "use": "step_name" をチェーンして、中間ダウンロードなしでマルチステップパイプラインを構築します。
• バッチ処理の場合、/http/import を使用して URL、S3、GCS、Azure、FTP、または Dropbox からファイルをプルします。
• テンプレートには、assembly 作成時に渡される動的値の ${variables} を含めることができます。