Processamento de Mídia com Transloadit

Processe, transforme e codifique arquivos de mídia usando a infraestrutura em nuvem do Transloadit. Suporta vídeo, áudio, imagens e documentos com mais de 86 robôs de processamento especializados.

Quando Usar Esta Habilidade

Use esta habilidade quando precisar:

• Codificar vídeo para HLS, MP4, WebM ou outros formatos
• Gerar miniaturas ou GIFs animados a partir de vídeo
• Redimensionar, cortar, adicionar marca d'água ou otimizar imagens
• Converter entre formatos de imagem (JPEG, PNG, WebP, AVIF, HEIF)
• Extrair ou transcodificar áudio (MP3, AAC, FLAC, WAV)
• Concatenar clipes de vídeo ou áudio
• Adicionar legendas ou sobrepor texto em vídeo
• Fazer OCR de documentos (PDF, imagens digitalizadas)
• Executar fala para texto ou texto para fala
• Aplicar moderação de conteúdo ou detecção de objetos baseada em IA
• Construir pipelines de mídia de várias etapas que encadeiam operações

Configuração

Opção A: Servidor MCP (recomendado para Copilot)

Adicione o servidor MCP do Transloadit à sua configuração do IDE. Isso dá ao agente acesso direto às ferramentas do Transloadit (create_template, create_assembly, list_assembly_notifications, etc.).

VS Code / GitHub Copilot (.vscode/mcp.json ou configurações do usuário):

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

Obtenha suas credenciais de API em https://transloadit.com/c/-/api-credentials

Opção B: CLI

Se preferir executar comandos diretamente:

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

Fluxos de Trabalho Principais

Codificar Vídeo para HLS (Streaming Adaptativo)

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

Gerar Miniaturas a Partir de Vídeo

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

Redimensionar e Adicionar Marca D'água em Imagens

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

Fazer OCR de um Documento

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

Concatenar Clipes de Áudio

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

Pipelines de Várias Etapas

As etapas podem ser encadeadas usando o campo "use". Cada etapa referencia a saída de uma etapa anterior:

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

Conceitos Chave

• Assembly: Um único trabalho de processamento. Criado via create_assembly (MCP) ou assemblies create (CLI).
• Template: Um conjunto reutilizável de etapas armazenado no Transloadit. Criado via create_template (MCP) ou templates create (CLI).
• Robot: Uma unidade de processamento (por exemplo, /video/encode, /image/resize). Veja a lista completa em https://transloadit.com/docs/transcoding/
• Steps: Objeto JSON que define o pipeline. Cada chave é um nome de etapa, cada valor configura um robô.
• :original: Refere-se ao arquivo de entrada carregado.

Dicas

• Use --wait com a CLI para bloquear até que o processamento seja concluído.
• Use valores preset (por exemplo, "hls-1080p", "mp3", "webp") para destinos de formato comuns em vez de especificar todos os parâmetros.
• Encadeie "use": "step_name" para construir pipelines de várias etapas sem downloads intermediários.
• Para processamento em lote, use /http/import para buscar arquivos de URLs, S3, GCS, Azure, FTP ou Dropbox.

…