Documentation

Make Video Pro CLI reference

Use the CLI to authorize a local session, process a video, render it, and save the finished MP4. For the AI-agent entrypoint, visit the AI page.

Get started

Node.js 18 or later is required. Run help first to retrieve the machine-readable command and parameter reference.

npx -y make-video-pro@latest help --json

Run login --json and approve the browser authorization.
Run languages --json before selecting language codes.
Fingerprint the local file, list active videos, reuse a matching video ID or upload when no MD5 matches, then update caption style when requested and render.

Active videos are automatically archived after 10 days without updates. Archived videos remain restorable for 30 days. After 30 days in the archive, videos are permanently deleted automatically and cannot be restored.

Common options

--json: Return deterministic JSON. Use this for automation.
--base-url <url>: Override the website URL for dev or staging.
-h, --help: Print command help.

Commands

help

Print human-readable or structured command help.

npx -y make-video-pro@latest help --json

--json: Return structured JSON help.

login

Authorize the CLI in your browser and store a local session.

npx -y make-video-pro@latest login --json

--no-open: Print the login URL without opening a browser.

logout

Revoke and remove the local CLI session.

npx -y make-video-pro@latest logout --json

languages

List the supported language codes for upload and rendering.

npx -y make-video-pro@latest languages --json

templates

List saved processing templates for the authorized account.

npx -y make-video-pro@latest templates --json

fingerprint

Calculate the source MD5 used to match an active uploaded video.

npx -y make-video-pro@latest fingerprint <file> --json

<file>: Local source video path.

upload

Upload source media and start captions, translation, voice, or clip processing.

npx -y make-video-pro@latest upload <file> --target-language <code> --wait --json

<file>: Local source video path.
--name <fileName>: Set the uploaded video name.
--task <task>: original, translation, or originalAndTranslated.
--language <code>: Alias for --original-language.
--original-language <code>: Source language code from languages.
--target-language <code>: Translation language code from languages.
--template <templateId>: Apply a saved template from templates.
--enable-tts, --no-enable-tts: Enable or disable AI voice generation.
--enable-clips, --no-enable-clips: Enable or disable AI clip generation.
--confirm-credits: Confirm credit usage when required.
--wait: Wait until the project is ready to render.

list

List all active videos and their source MD5 values.

npx -y make-video-pro@latest list --json

status

Check processing, readiness, render state, and next action for a video.

npx -y make-video-pro@latest status <videoId> --json

<videoId>: Video ID returned by upload or list.
--raw: Include the raw project payload.

restore

Restore an archived video when an active-video slot is available.

npx -y make-video-pro@latest restore <videoId> --json

<videoId>: Archived video ID to restore.

style

Show or update caption style before rendering.

npx -y make-video-pro@latest style <videoId> --font-color '#ffffff' --font-size 48 --json

<videoId>: Video ID returned by upload or list.
--font-color, --font-size, --font-family, --font-weight: Set the main caption font.
--sub-font-color, --sub-font-size, --sub-font-family: Set the secondary caption font.
--highlight-color, --highlight-size, --highlight-font-family, --highlight-font-weight: Set highlighted caption font values.
--highlight-sub-color, --highlight-sub-size, --highlight-sub-font-family: Set highlighted secondary caption font values.
--background-color, --background-padding, --background-rounded: Set caption background values.
--background, --no-background: Show or hide the caption background.
--shadow, --no-shadow: Enable or disable caption text shadow.
--keep-on-bottom, --no-keep-on-bottom: Control caption bottom positioning.
--highlight, --no-highlight: Enable or disable keyword highlighting.

render

Start or inspect cloud rendering for a ready video.

npx -y make-video-pro@latest render <videoId> --confirm-credits --wait --json

<videoId>: Video ID to render.
--confirm-credits: Required before paid cloud rendering.
--wait: Wait until cloud rendering completes.
--force: Start a new render instead of reusing a completed valid render.
--language <code|original>: Caption language for the export.
--audio-language <code|original>: Audio language for the export.
--sub-caption-language <code|none>: Secondary caption language.
--quality <value>: Export quality; default is high.
--clip <clipId|original>: Render a generated clip or the original video.
--no-intro, --no-outro, --no-watermark: Disable intro, outro, or watermark.

render-local

Render a ready video with the optional local Remotion package.

npx -y --package make-video-pro@latest --package make-video-pro-local-renderer@latest make-video-pro render-local <videoId> -o ./exports/output.mp4 --json

<videoId>: Video ID to render locally.
-o, --output <path>: Output MP4 path.
--overwrite: Replace an existing output file.
--language <code|original>: Caption language for the export.
--audio-language <code|original>: Audio language for the export.
--sub-caption-language <code|none>: Secondary caption language.
--quality <value>: Export quality; default is high.
--clip <clipId|original>: Render a generated clip or the original video.
--no-intro, --no-outro, --no-watermark: Disable intro, outro, or watermark.

download

Download a completed cloud render.

npx -y make-video-pro@latest download <videoId> -o ./exports/output.mp4 --json

<videoId>: Video ID to download.
-o, --output <path>: Output MP4 path.
--overwrite: Replace an existing output file.
--render: Start cloud rendering if no completed render exists.
--confirm-credits: Allow --render to spend credits after confirmation.