transloadit-media-processing

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

在 https://transloadit.com/c/-/api-credentials 取得您的 API 憑證

選項 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 拉取檔案。
• 範本可以包含 ${variables}，用於在建立 assembly 時傳入動態值。