zerocut-cli-tools（zerocut CLI tools 文档）

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.
• --output saves files to an absolute path resolved from current working directory.
• Missing parent directories for --output are created automatically.