viduq2-i2v

Vidu image-to-video model, supports reference image-driven video, duration/resolution/ratio, and audio settings, suitable for image animation and short clips.

Overview

Field	Value
Model ID	`vidu-i2v-viduq2`
CLI	`dlazy viduq2-i2v`
MCP	`viduq2-i2v` (Claude Code surfaces this as `mcp__dlazy__viduq2-i2v`)
Type	`video`
Execution	Async task; the CLI polls until completion (`--no-wait` returns `generateId` immediately)
Batch	Supports `--batch <n>` parallel fan-out

Parameters

Arg	Type	Required	Notes
`prompt`	string	Yes	Prompt
`generation_mode`	"components" \| "frames"	No	Generation Mode（components=Components; frames=Frames）; default `"components"`
`images`	array<url>	No	Images; image (accepts URL, local path, or data: URL); max 10 items; only when !(generation_mode="frames")
`firstFrame`	url	No	First Frame; image (accepts URL, local path, or data: URL); only when generation_mode="frames"
`lastFrame`	url	No	Last Frame; image (accepts URL, local path, or data: URL); only when generation_mode="frames"
`subjects`	array<string>	No	Subjects; max 7 items; only when !(generation_mode="frames")
`audio`	"true" \| "false"	No	Audio; default `"false"`
`audioType`	"all" \| "speech_only"	No	Audio Type; default `"all"`; only when !(generation_mode="frames")
`duration`	"2" \| "3" \| "4" \| "5" \| "6" \| "7" \| "8" \| "9" \| "10"	No	Duration (s); default `"5"`
`aspectRatio`	"16:9" \| "9:16" \| "1:1" \| "3:4" \| "4:3" \| "21:9" \| "2:3" \| "3:2"	No	Aspect Ratio; default `"9:16"`
`resolution`	"540p" \| "720p" \| "1080p"	No	Resolution; default `"720p"`

--input @file.json or --input '{...}' can supply all args at once; flags take precedence over --input keys.

CLI Examples

dlazy viduq2-i2v --help
dlazy viduq2-i2v --prompt "Write your prompt here" --images "https://example.com/reference1.jpg" "https://example.com/reference2.jpg"
dlazy viduq2-i2v --prompt "Write your prompt here" --images "./local-image.png"
dlazy viduq2-i2v --prompt "Write your prompt here" --images "https://example.com/reference1.jpg" "https://example.com/reference2.jpg" --dry-run
dlazy viduq2-i2v --prompt "Write your prompt here" --images "https://example.com/reference1.jpg" "https://example.com/reference2.jpg" --no-wait
dlazy viduq2-i2v --prompt "Write your prompt here" --images "https://example.com/reference1.jpg" "https://example.com/reference2.jpg" --batch 4

Compose with a pipeline

dlazy gpt-image-2 --prompt "reference visual" \
  | dlazy viduq2-i2v --images - --prompt "Write your prompt here"

MCP is consumed by AI clients, not handwritten. Once dLazy is registered as an MCP server the tool appears in the client's tool list — Claude Code surfaces it as mcp__dlazy__viduq2-i2v; generic clients (e.g. OpenClaw) call it as viduq2-i2v.

See MCP setup for how to add the server.

Output

{
  "outputs": [
    { "type": "video", "id": "o_...", "url": "https://files.dlazy.com/result.mp4", "mimeType": "video/mp4" }
  ]
}

Media tools emit image / video / audio / file outputs. Use --output url to print only the URLs on stdout.