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 时传递动态值。