zerocut-cli-tools
v1.0.0Use ZeroCut CLI media and document tools. Invoke when user needs generate media, run ffmpeg/pandoc, sync resources, or save outputs.
Installation Guide
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 <prompt> required
- --model <model>
- --aspectRatio <ratio>
- --resolution <resolution>
- --refs <refs> comma-separated local paths or URLs
- --output <file> 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 <prompt> required
- --video <model>
- --duration <seconds>
- --seed <seed>
- --firstFrame <image>
- --lastFrame <image>
- --refs <assets>
- --resolution <resolution>
- --aspectRatio <ratio>
- --withAudio
- --optimizeCameraMotion
- --output <file>
music
Default action: create
zerocut music --prompt "lofi beat" --output music.mp3
zerocut music create --prompt "lofi beat" --output music.mp3
Options:
- --prompt <prompt> required
- --output <file>
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 <prompt>
- --text <text> required
- --voiceId <voiceId>
- --output <file>
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 <args...> required, arguments appended after ffmpeg
- --resources <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 <args...> required, arguments appended after pandoc
- --resources <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.
--outputsaves files to an absolute path resolved from current working directory.- Missing parent directories for
--outputare created automatically.