ZeroCut CLI Tools

Purpose

This skill provides a single reference for using ZeroCut CLI commands:

• image generation
• video generation
• music generation
• text-to-speech
• ffmpeg sandbox execution
• pandoc sandbox execution

When To Invoke

Invoke this skill when the user asks to:

• generate image, video, music, or speech audio
• run ffmpeg or ffprobe command in sandbox
• run pandoc conversion in sandbox
• sync local/remote resources into sandbox
• save generated results to local output files

Command Reference

image

Default action: create

zerocut image --prompt "a cat on a bike" --output out.png
zerocut image create --prompt "a cat on a bike" --model seedream-5l --aspectRatio 1:1 --resolution 1K --refs ref1.png,ref2.jpg --output out.png

Options:

• --prompt required
• --model
• --aspectRatio
• --resolution
• --refs comma-separated local paths or URLs
• --output save generated file

video

Default action: create

zerocut video --prompt "city night drive" --video vidu --duration 8 --output out.mp4
zerocut video create --prompt "city night drive" --video vidu --aspectRatio 1:1 --refs ref1.png,ref2.png --output out.mp4

Options:

• --prompt required
• --video
• --duration
• --seed
• --firstFrame
• --lastFrame
• --refs
• --resolution
• --aspectRatio
• --withAudio
• --optimizeCameraMotion
• --output

music

Default action: create

zerocut music --prompt "lofi beat" --output music.mp3
zerocut music create --prompt "lofi beat" --output music.mp3

Options:

• --prompt required
• --output

tts

Default action: create

zerocut tts --text "你好，欢迎使用 ZeroCut" --voiceId voice_xxx --output speech.mp3
zerocut tts create --prompt "calm tone" --text "Hello world" --voiceId voice_xxx --output speech.mp3

Options:

• --prompt
• --text required
• --voiceId
• --output

ffmpeg

zerocut ffmpeg --args -i input.mp4 -vn output.mp3 --resources input.mp4
zerocut ffmpeg --args -i input.mp4 -vf scale=1280:720 output.mp4 --resources input.mp4

Options:

• --args required, arguments appended after ffmpeg
• --resources optional, files/URLs to sync into sandbox materials

Behavior:

• command is validated to only allow ffmpeg or ffprobe
• for ffmpeg, -y is auto-injected when absent
• output file is auto-downloaded from sandbox to local current directory

pandoc

zerocut pandoc --args input.md -o output.pdf --resources input.md
zerocut pandoc --args input.md --output=output.docx --resources input.md template.docx

Options:

• --args required, arguments appended after pandoc
• --resources optional, files/URLs to sync into sandbox materials

Behavior:

• command is validated to only allow pandoc
• output file must be specified in args with -o, --output, or --output=...
• output file is auto-downloaded from sandbox to local current directory

Output And Sync Rules

• Media URLs from generation are synced to TOS when available.
• --output saves files to an absolute path resolved from current working directory.
• Missing parent directories for --output are created automatically.