Transloadit CLI

Your media pipeline, one command away

Upload, transform, and automate files directly from your terminal. Use it locally, in CI/CD, or as a dependable execution layer for AI agents.

$ npx -y @transloadit/node --help

Available through @transloadit/node. Requires Node.js 20 or newer.

$transloadit assemblies create --template $TEMPLATE_ID --watch

  • Watching ./incoming for new files
  • Queued 24 files across 3 Steps
  • Exported every result to S3
  • Ran 3 Steps in parallel
  • 24 files processed, 0 failed
Automation without glue code

From a single file to a production workflow

Use readable intent commands for common jobs, or execute complete Templates when your workflow needs multiple processing steps.
Files in, results out

Accept local paths, directories, URLs, base64 data, or stdin and write results exactly where your workflow expects them.

Built for batches

Process directories recursively, watch for new files, and control parallelism without building your own queue.

One media toolbox

Run image, video, audio, document, archive, and AI operations through the same predictable interface.

Structured automation

Use JSON output and standard exit behavior to compose commands with scripts, CI jobs, and the rest of your toolchain.

Agent-ready access

Mint scoped, short-lived bearer tokens when an AI agent needs controlled access to Transloadit.

Cloud execution

Keep FFmpeg, ImageMagick, codecs, and processing capacity out of your local environment and CI runners.

Useful from the first command

Reach across the entire media stack

Intent commands turn common media jobs into discoverable flags while still giving you access to Transloadit’s complete Assembly and Template APIs.

Images and AI

Generate, resize, optimize, merge, upscale, or remove image backgrounds.

$transloadit image generate --prompt "sunset"

Documents

Convert, optimize, rotate, or create thumbnails from business documents.

$transloadit document convert --input notes.docx

Video

Prepare video for adaptive streaming or extract representative thumbnails.

$transloadit video encode-hls --input launch.mp4

Audio

Transcode, normalize, concatenate, or extract the audio from a video.

$transloadit audio encode --input podcast.wav

Transloadit CLI questions

Is the CLI a separate Transloadit product?

The CLI ships with the official @transloadit/node package, so the SDK and terminal interface stay aligned. You can invoke it through npx or install the package globally.

What happened to Transloadify?

Transloadify was our original command-line tool. Its functionality moved into the actively maintained Node.js SDK. See the migration guide for equivalent commands.

How do I authenticate?

Set TRANSLOADIT_KEY and TRANSLOADIT_SECRET in your environment, then run any command. For every flag and authentication option, read the Node.js SDK and CLI documentation.

Can I use it in CI/CD?

Yes. Supply credentials through environment variables, select JSON output when a subsequent step needs structured data, and run intent or Template commands non-interactively.

Can it execute my existing Templates?

Yes. The assemblies commands can create processing jobs from stored Templates, local Assembly Instructions, individual files, or entire directories.

Stop scripting around your media infrastructure

Run your first command for free, then move the same workflow into CI, production automation, or an AI agent when you are ready.
No credit card needed