vidu-cli-0.2.4 is not a library.

vidu-cli

A command-line client for the Vidu video generation API.

Installation

cargo install vidu-cli

Configuration

Set environment variables:

export VIDU_TOKEN=your_api_token
export VIDU_BASE_URL=https://service.vidu.cn  # China: service.vidu.cn, Global: service.vidu.com

Usage

vidu-cli <COMMAND>

Commands:
  upload   Upload image → get ssupload URI
  task     Task operations
  element  Element (主体) operations

Upload

Upload a local image and get a reusable ssupload:?id=xxx URI:

vidu-cli upload ./photo.jpg

Task

Submit a task

vidu-cli task submit --type <TYPE> --prompt <PROMPT> --duration <DURATION> \
  --model-version <VERSION> --resolution <RESOLUTION> [OPTIONS]

Task types and constraints:

Type	Models	Duration	Resolution	Aspect Ratio
`text2video`	3.0, 3.1, 3.2	3.0→5s, 3.1→2-8s, 3.2→1-16s	1080p	16:9, 9:16, 1:1, 4:3, 3:4
`img2video`	3.0, 3.1, 3.2	3.0→5s, 3.1→2-8s, 3.2→1-16s	1080p	—
`headtailimg2video`	3.0, 3.1, 3.2	3.0→5s, 3.1→2-8s, 3.2→1-16s	1080p	—
`character2video`	3.0, 3.1, 3.1_pro, 3.2	3.0→5s, 3.1→2-8s, 3.2→1-16s	1080p	16:9, 9:16, 1:1, 4:3, 3:4
`text2image`	3.1, 3.2_fast_m, 3.2_pro_m	0 (image)	1080p, 2k, 4k	16:9, 9:16, 1:1, 4:3, 3:4
`reference2image`	3.1, 3.2_fast_m, 3.2_pro_m	0 (image)	1080p, 2k, 4k	16:9, 9:16, 1:1, 4:3, 3:4

Examples:

# Text to video
vidu-cli task submit \
  --type text2video \
  --prompt "a cat walking in the rain" \
  --model-version 3.2 \
  --duration 8 \
  --resolution 1080p \
  --aspect-ratio 16:9

# Image to video (local file or URL)
vidu-cli task submit \
  --type img2video \
  --prompt "the scene comes alive" \
  --model-version 3.1 \
  --duration 4 \
  --resolution 1080p \
  --image ./scene.jpg

# First-last frame video
vidu-cli task submit \
  --type headtailimg2video \
  --prompt "smooth transition" \
  --model-version 3.2 \
  --duration 5 \
  --resolution 1080p \
  --image ./start.jpg \
  --image ./end.jpg

# Character to video (with element material)
vidu-cli task submit \
  --type character2video \
  --prompt "character walks forward" \
  --model-version 3.2 \
  --duration 4 \
  --resolution 1080p \
  --transition pro \
  --image ./character.jpg \
  --material "mychar:element-id:1"

Get task result

vidu-cli task get <TASK_ID> [--output <DIR>]

Returns: task_id, state, type, model, err_code, err_msg.

Use --output / -o to download media files to a local directory when the task is complete:

vidu-cli task get <TASK_ID> --output ./results

If the task state is not success, the download is skipped and the response includes download_skipped: true.

Lip sync

Drive mouth movement on an existing video using text or audio:

# Text mode
vidu-cli task lip-sync --video ./clip.mp4 --text "Hello, world!" --voice-id English_Aussie_Bloke

# Audio mode
vidu-cli task lip-sync --video ./clip.mp4 --audio ./speech.mp3

Supported video: MP4/MOV/AVI ≤500MB. Supported audio: MP3/WAV/AAC/M4A ≤100MB.

List available lip-sync voices

vidu-cli task lip-sync-voices

TTS (Text-to-Speech)

Convert text to speech audio:

# Basic usage
vidu-cli task tts --prompt "Hello, this is a test." --voice-id English_Trustworth_Man

# Full parameters
vidu-cli task tts \
  --prompt "你好，这是一个测试。" \
  --voice-id "Chinese (Mandarin)_Reliable_Executive" \
  --speed 1.2 \
  --volume 80 \
  --emotion "happy" \
  --language-boost "Chinese"

Parameters:

Parameter	Required	Default	Range	Description
`--prompt`	Yes	-	1-2000 chars	Text content to convert to speech
`--voice-id`	Yes	-	See voice list	Voice ID for speech synthesis
`--speed`	No	1.0	0.5-2.0	Speech speed multiplier
`--volume`	No	80	0-100	Audio volume level
`--emotion`	No	-	Any text	Emotion description (optional)
`--language-boost`	No	-	Chinese, English, auto, etc.	Enhance recognition of specific languages/dialects

List available TTS voices

vidu-cli task tts-voices

Element (主体)

Manage reusable character/material elements:

# Check if element name is available
vidu-cli element check --name "mychar"

# Pre-process element image
vidu-cli element preprocess --image ./char.jpg

# Create element
vidu-cli element create --name "mychar" --image ./char.jpg

# List your elements
vidu-cli element list

# Search community elements
vidu-cli element search --query "anime girl"

License

MIT

vidu-cli 0.2.4