dlazy-kling-v3-omni

English · 中文

基于 Kling v3 Omni 的多功能视频生成能力。支持多模态输入，可生成高质量、动态的视频内容。

触发关键词

• kling v3 omni
• generate omni video
• text to video, image to video

身份认证

所有请求均需提供 dLazy API 密钥，该密钥通过 CLI 进行配置：

dlazy auth set YOUR_API_KEY

CLI 会将密钥保存至您的用户配置目录（macOS/Linux 下为 ~/.dlazy/config.json，Windows 下为 %USERPROFILE%.dlazyconfig.json），并限制文件权限仅对当前操作系统用户可见。您也可在每次调用时通过 DLAZY_API_KEY 环境变量传入密钥。

获取您的 API 密钥

1. 访问 dlazy.com 并登录或注册账户
2. 进入 dlazy.com/dashboard/organization/api-key
3. 复制 API Key 区域中显示的密钥

每个密钥均绑定至您的 dLazy 组织，且可在同一控制台中随时轮换或撤销。

关于本工具及来源信息

• CLI 源代码: github.com/dlazyai/cli
• 维护者: dlazyai
• npm 包: @dlazy/cli（本技能安装规范中固定使用 1.0.9 版本）
• 主页: dlazy.com

您可通过以下命令按需运行，无需全局安装二进制文件：

npx @dlazy/cli@1.0.9 

或者，若您偏好全局安装，该技能的 metadata.clawdbot.install 字段已声明精确锁定版本（即执行 npm install -g @dlazy/cli@1.0.9）。安装前请务必查阅 GitHub 源码。

工作原理

本技能是 dLazy 托管 API 的轻量级客户端。当您调用它时：

• 您提供的提示词（prompt）与参数将被发送至 dLazy API 接口（api.dlazy.com）进行模型推理。
• 您传入图像 / 视频 / 音频字段的任何本地文件路径，均会被上传至 dLazy 媒体存储服务（files.dlazy.com），以便模型读取——此流程与任意基于云的生成类 API 一致。
• API 返回的生成结果 URL 均托管于 files.dlazy.com。

这是标准的 SaaS 架构模式；本技能自身不直接访问网络或文件系统资源，所有 I/O 操作均由 dLazy CLI 统一处理。完整服务条款请参阅 dlazy.com。

使用方法

代理（AGENT）关键指令： 请运行 dlazy kling-v3-omni 命令以获取结果。

dlazy kling-v3-omni -h

Options:
  --prompt [prompt]                    Prompt
  --generation_mode [generation_mode]  Generation Mode [default: frames] (choices: "frames", "components")
  --images [images...]                 Images [image: url or local path] (max 7)
  --subjects [subjects...]             Subjects (max 3) [only when !(generation_mode="frames")]
  --videos [videos...]                 Videos [video: url or local path] (max 1) [only when !(generation_mode="frames")]
  --video_refer_type [video_refer_type]Video Refer Type [default: feature] (choices: "feature", "base") [only when videos non-empty]
  --keep_original_sound [keep_original_sound]Keep Original Sound [default: false] [only when videos non-empty]
  --aspect_ratio [aspect_ratio]        Aspect Ratio [default: 16:9] (choices: "16:9", "9:16", "1:1") [only when !(videos non-empty && video_refer_type="base")]
  --duration [duration]                Duration (s) [default: 5] (choices: "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15") [only when !(videos non-empty && video_refer_type="base")]
  --mode [mode]                        Mode [default: std] (choices: "std", "pro")
  --sound [sound]                      Sound Effect [default: false]
  --dry-run                            Print payload + cost estimate without calling API
  --no-wait                            Return generateId immediately for async tasks
  --timeout                   Max seconds to wait for async completion (default: "1800")
  -h, --help                           display help for command

所有选项均支持管道引用语法 —— -（自动从上游 stdin 获取）、@N（第 N 个输出）、@N.path（对输出执行 JSONPath 查询）、@*（全部主值）、@stdin / @stdin:path（完整信封）。详情请参见 dlazy --help。

输出格式

{
  "ok": true,
  "result": {
    "tool": "kling-v3-omni",
    "modelId": "kling-v3-omni",
    "outputs": [
      {
        "type": "image",
        "id": "o_xxxxxxxx",
        "url": "https://files.dlazy.com/result.png",
        "mimeType": "image/png"
      }
    ]
  }
}

异步任务（启用 --no-wait 参数时）将返回空数组 outputs: []，并额外包含 task: { generateId, status } 字段。请使用 dlazy status --wait 进行轮询查询。

命令示例

# 基础调用：
dlazy kling-v3-omni --prompt 'prompt text' --image '/path/to/image.png'

# 复杂调用：
dlazy kling-v3-omni --prompt 'prompt text' --image 'https://files.dlazy.com/image.png'

错误处理

代理（AGENT）关键指令：

1. 若执行结果返回 code: "insufficient_balance"，您必须明确告知用户其积分余额不足，并引导其前往 https://dlazy.com/dashboard/organization/settings?tab=credits 充值。
2. 若执行结果返回 code: "unauthorized" 或提示 API 密钥缺失，您必须告知用户前往 https://dlazy.com/dashboard/organization/api-key 获取密钥，并通过 dlazy auth set 命令保存密钥，之后恢复任务执行。

使用提示

更多信息请访问 https://dlazy.com。