dlazy-viduq2-i2v

English · 中文

Convert static images into dynamic videos using Vidu Q2 image-to-video model.

Trigger Keywords

• vidu q2
• image to video
• image to dynamic video

Authentication

All requests require a dLazy API key, configured through the CLI:

dlazy auth set YOUR_API_KEY

The CLI saves the key in your user config directory (~/.dlazy/config.json on macOS/Linux, %USERPROFILE%\.dlazy\config.json on Windows), with file permissions restricted to your OS user account. You can also supply the key per-invocation via the DLAZY_API_KEY environment variable.

Getting Your API Key

1. Sign in or create an account at dlazy.com
2. Go to dlazy.com/dashboard/organization/api-key
3. Copy the key shown in the API Key section

Each key is scoped to your dLazy organization and can be rotated or revoked at any time from the same dashboard.

About & Provenance

• CLI source code: github.com/dlazyai/cli
• Maintainer: dlazyai
• npm package: @dlazy/cli (pinned to 1.0.8 in this skill's install spec)
• Homepage: dlazy.com

You can install on demand without persisting a global binary by running:

npx @dlazy/[email protected] \x3Ccommand>

Or, if you prefer a global install, the skill's metadata.clawdbot.install field declares the exact pinned version (npm install -g @dlazy/[email protected]). Review the GitHub source before installing.

How It Works

This skill is a thin client over the dLazy hosted API. When you invoke it:

• Prompts and parameters you provide are sent to the dLazy API endpoint (api.dlazy.com) for inference.
• Any local file paths you pass to image / video / audio fields are uploaded to dLazy's media storage (oss.dlazy.com) so the model can read them — the same flow as any cloud-based generation API.
• Generated output URLs returned by the API are hosted on oss.dlazy.com.

This is the standard SaaS pattern; the skill itself does not access network or filesystem resources beyond what the dLazy CLI already handles. See dlazy.com for the full service terms.

Usage

CRITICAL INSTRUCTION FOR AGENT: Run the dlazy viduq2-i2v command to get results.

dlazy viduq2-i2v -h

Options:
  --prompt \x3Cprompt>                    Prompt
  --generation_mode \x3Cgeneration_mode>  Generation Mode [default: components] (choices: "components", "frames")
  --images \x3Cimages...>                 Images [image: url or local path] (max 10) [only when !(generation_mode="frames")]
  --firstFrame \x3CfirstFrame>            First Frame [image: url or local path] [only when generation_mode="frames"]
  --lastFrame \x3ClastFrame>              Last Frame [image: url or local path] [only when generation_mode="frames"]
  --subjects \x3Csubjects...>             Subjects (max 7) [only when !(generation_mode="frames")]
  --audio \x3Caudio>                      Audio [default: false] (choices: "true", "false")
  --audioType \x3CaudioType>              Audio Type [default: all] (choices: "all", "speech_only") [only when !(generation_mode="frames")]
  --duration \x3Cduration>                Duration (s) [default: 5] (choices: "2", "3", "4", "5", "6", "7", "8", "9", "10")
  --aspectRatio \x3CaspectRatio>          Aspect Ratio [default: 9:16] (choices: "16:9", "9:16", "1:1", "3:4", "4:3", "21:9", "2:3", "3:2")
  --resolution \x3Cresolution>            Resolution [default: 720p] (choices: "540p", "720p", "1080p")
  --watermark \x3Cwatermark>              Watermark [default: false] (choices: "true", "false")
  --wmPosition \x3CwmPosition>            Watermark Position [default: 3] (choices: "1", "2", "3", "4")
  --wmUrl \x3CwmUrl>                      Watermark URL
  --promptRefs \x3CpromptRefs...>         promptRefs [default: ]
  --input \x3Cspec>                       JSON payload: inline string, @file, or - (stdin)
  --dry-run                            Print payload + cost estimate without calling API
  --no-wait                            Return generateId immediately for async tasks
  --timeout \x3Cseconds>                  Max seconds to wait for async completion (default: "1800")
  -h, --help                           display help for command

Output Format

{
  "ok": true,
  "kind": "urls",
  "data": {
    "urls": [
      "https://oss.dlazy.com/result.mp4"
    ]
  }
}

Command Examples

# basic call:
dlazy viduq2-i2v --prompt 'prompt text' --image '/path/to/image.png'

# complex call:
dlazy viduq2-i2v --prompt 'prompt text' --image 'https://oss.dlazy.com/image.png'

Error Handling

AGENT CRITICAL INSTRUCTION:

1. If the execution result returns code: "insufficient_balance", you MUST explicitly inform the user that their credits are insufficient and guide them to recharge: https://dlazy.com/dashboard/organization/settings?tab=credits
2. If the execution result returns code: "unauthorized" or indicates missing API key, you MUST inform the user to get their API key from https://dlazy.com/dashboard/organization/api-key and save it using dlazy auth set \x3Ckey> and resume the task.

Tips

Visit https://dlazy.com for more information.