vidu-skills

name: vidu-skills description: Generate video and images by calling the official Vidu API via vidu CLI. Use when the user wants text-to-image, text-to-video, image-to-video, head-tail-image-to-video, reference-to-image, reference-to-video, lip-sync, text-to-speech, video-compose, Create References, or to submit or check Vidu tasks. Requires VIDU_TOKEN and optional VIDU_BASE_URL. version: 1.4.15 homepage: https://www.vidu.cn/ primaryEnv: VIDU_TOKEN metadata: {"openclaw":{"requires":{"bins":["node","npm","vidu-cli"],"env":["VIDU_TOKEN"]},"primaryEnv":"VIDU_TOKEN","install":[{"id":"vidu-cli","kind":"node","package":"vidu-cli","bins":["vidu-cli"],"label":"Install vidu-cli via npm (requires Node.js >=14; postinstall downloads a platform binary from GitHub)"}]}}

Vidu Video and Image Generation Skill

Generate AI videos and images with Vidu via vidu-cli: text-to-image, text-to-video, image-to-video, start/end-frame video, reference-based generation, reusable elements, TTS, lip-sync, and compose.

Execution Model

All execution uses the vidu-cli CLI. Use CLI flags, not raw JSON request bodies. Use argv arrays; do not wrap commands in shell strings.

Vidu creator tasks are async: submit returns task_id; poll with vidu-cli task get <task_id> and download with vidu-cli task get <task_id> -o <dir>.

Environment:

• VIDU_TOKEN (required): Vidu API token.
• VIDU_BASE_URL (optional): default https://service.vidu.cn; use https://service.vidu.com for overseas.
• VIDU_DEBUG=1 (optional): print full response body to stderr for debugging.

For installation, token setup, and first-run checks, read references/setup.md only when the user is setting up the skill or the CLI is missing.

Decision Table

Do Not Invent

Never use these:

• vidu-cli reference ...
• vidu-cli reference create-image-reference
• vidu-cli task submit --type tts
• vidu-cli task tts --voice ...
• vidu-cli task submit --output ...
• vidu-cli task download
• vidu-cli task submit --material "a:id:ver,b:id:ver"
• sh -c "vidu-cli ..."

Minimal Rules

• Every async creator command (task submit, task tts, task compose, task lip-sync) must go through provider_batch, even for one item.
• Use direct argv arrays; put every flag and value in separate argv entries.
• Repeat --image, --material, --audio, and --video once per item. Do not comma-join.
• reference2image and character2video require non-empty prompt plus 1-7 total references (--image + --material).
• Image tasks use --duration 0; reusable element create has no duration.
• For character2video with 3.2_a, duration must be an explicit 4-15; for other models, check references/parameters.md.
• Download successful media with vidu-cli task get <task_id> --output <dir>; when subtitle_uri is present, this also downloads subtitle JSON.
• Report CLI/API errors from JSON fields exactly; do not infer hidden causes.

Common Shapes

vidu-cli element create --name "角色A" --image /path/a.png --description "..." --style "..."

vidu-cli task submit --type reference2image --prompt "..." --image /path/a.png --duration 0 --model-version 3.2_image_2 --resolution 1080p

vidu-cli task submit --type character2video --prompt "[@角色A] walks into office" --material "角色A:ID:VERSION" --duration 5 --model-version 3.2_a --resolution 1080p

vidu-cli task tts --prompt "旁白文本" --voice-id "Chinese (Mandarin)_Gentleman" --speed 1.3

Load References Only When Needed

• references/parameters.md: exact model matrix, durations, flags, examples, validation details.
• references/compose.md: required before building compose timeline JSON.
• references/errors_and_retry.md: lifecycle states, retry behavior, polling edge cases.
• references/setup.md: installation, environment variables, first-run checks, and external-user setup notes.

If local CLI help conflicts with this file, trust vidu-cli <subcommand> --help and update this skill afterward.