explainer-video

English · 中文

PPT 转视频、Word 转视频、Excel 转视频、PDF 转视频、文档转视频 —— 解析、生成大纲、制作分镜脚本、添加配音、构建视频、验证输出。当用户提交一份文档，并希望将其转化为讲解视频、汇报广播、课件或培训视频时使用。

触发关键词

• 文档转视频
• PPT 转视频
• PDF 讲解
• document to video
• explainer video
• 课件视频
• 报告解读

认证方式

所有请求均需提供 dLazy API 密钥。推荐的认证方式为：

dlazy login

该命令将启动设备码（device-code）流程（亦适用于远程 shell），并自动将您的 API 密钥保存至本地 CLI 配置文件中，无需手动复制/粘贴。

替代方案：手动设置密钥

若您已拥有 API 密钥，可直接保存：

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.2.3）
• 官网: dlazy.com

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

npx @dlazy/cli@1.2.3 

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

工作原理

本技能是运行于 dLazy 托管 sandbox agent 之上的轻量客户端。当您调用它时：

• 您的消息与参数将发送至 dLazy API（api.dlazy.com），API 实时流式返回 agent 的响应至您的终端。
• 您通过 --files 附加的任何本地文件，将首先上传至 dLazy 媒体存储服务（files.dlazy.com），再以 URL 形式被引用。
• 对话会话按项目（project）进行追踪，以便后续交互保持上下文；项目 ID 可通过 dlazy projects list 获取。

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

使用方法

本技能对接 dlazy sandbox agent，固定使用 file-to-video 模板——这是一个按项目作用域组织的助手，可在多轮交互中端到端执行该模板全流程。

发现已有项目

# 列出您组织内所有现有项目
dlazy projects list

启动或继续项目

# 使用该模板启动新项目
dlazy chat --skill file-to-video --prompt "..."

# 继续已有项目（此时无需指定 --skill）
dlazy chat --project  --prompt "..."

# 附加本地文件（将先上传至媒体存储）
dlazy chat --project  --prompt "请参考此文件" --files ref.png

# 会话控制指令
dlazy chat --project  --clear      # 清除已保存的会话，重新开始
dlazy chat --project  --compact    # 压缩当前会话上下文（减少 token 占用）

在 TTY 终端中，dlazy chat 在首轮响应后将持续保持交互状态——您可直接输入后续消息，或键入 exit 退出。

代理（AGENT）关键操作指令：

1. 对于全新任务，请运行 dlazy chat --skill file-to-video --prompt "..."。
2. 若需延续此前工作，请使用 --project （ID 可通过 dlazy projects list 查询）——切勿同时指定 --skill 和 --project。
3. 在非交互式（无 TTY）运行场景下，必须始终传入 --prompt 参数。
4. 运行 dlazy chat -h 查看全部可用选项。

错误处理

代理（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。