📦 Dlazy 脚本

dlazy-script English · 中文 分镜脚本生成器。给定简短描述与可选参考图，返回结构化脚本（主体+分镜）及扁平画布形状列表，供下游生成使用。

触发关键词 script

认证 所有请求需 dLazy API key。推荐方式： dlazy login 启动设备码流程（远程 shell 亦可用），自动将 API key 保存至本地 CLI 配置，无需手动复制。

替代：手动设置密钥 若已有 API key，可直接保存： dlazy auth set YOUR_API_KEY CLI 将密钥存入用户配置目录（macOS/Linux：~/.dlazy/config.json，Windows：%USERPROFILE%\.dlazy\config.json），文件权限仅限当前用户。 也可每次调用时通过环境变量 DLAZY_API_KEY 传入。

手动获取 API key

• 登录或注册 dlazy.com
• 访问 dlazy.com/dashboard/organization/api-key
• 复制“API Key”栏内容

关于 & 来源 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 的轻量客户端。调用时：

• 提示与参数发送至 dLazy API 端点 api.dlazy.com 进行推理。
• 本地图片/视频/音频路径将上传至 dLazy 媒体存储 files.dlazy.com，供模型读取（与任何云端生成 API 相同流程）。
• 生成结果 URL 由 files.dlazy.com 托管，标准 SaaS 模式；技能本身不额外访问网络或文件系统。

用法 关键指令：执行 dlazy script 获取结果。

dlazy script -h 选项： --prompt [prompt] 自由格式描述（故事/主题/风格/节奏） --images [images...] 可选参考图（角色/场景/风格参考）；支持 URL 或本地路径（由 CLI 上传）[image: url or local path] --dry-run 打印请求体 + 费用估算，不调用 API --no-wait 立即返回 generateId，用于异步任务 --timeout 异步完成最大等待秒数（默认 1800） -h, --help 显示命令帮助

所有标志均支持管道引用：-（自动取上游 stdin）、@N（第 N 个输出）、@N.path（JSONPath）、@*（全部主值）、@stdin / @stdin:path（完整信封）。详见 dlazy --help。

输出格式 { "ok": true, "result": { "tool": "script", "modelId": "script", "outputs": [ { "type": "json", "id": "o_xxxxxxxx", "value": {} } ] } } 异步任务（带 --no-wait）返回 outputs: [] 与 task: { generateId, status }。可用 dlazy status --wait 轮询。

示例 dlazy script --prompt 'prompt content'

错误处理 代码 | 错误类型 | 示例消息 401 | 未授权（无 API key） | ok: false, code: "unauthorized", message: "API key is missing or invalid" 501 | 缺少必填参数 | error: required option '--prompt ' not specified 502 | 本地文件读取错误 | Error: Image file/Video file not found: C:\path\to\your\file 503 | API 请求失败（余额不足） | ok: false, code: "insufficient_balance" 503 | API 请求失败（服务端错误） | HTTP status code error (500 server crash) 504 | 异步任务执行失败 | === Generation Failed === / {后端返回的具体错误，如“Prompt violates safety policy”}

关键提示：

• 若返回 code: "insufficient_balance"，必须明确告知用户余额不足，并引导充值：https://dlazy.com/dashboard/organization/settings?tab=credits
• 若返回 code: "unauthorized" 或提示缺少 API key，必须告知用户前往 https://dlazy.com/dashboard/organization/api-key 获取 key，并用 dlazy auth set 保存后重试。

更多帮助 访问 https://dlazy.com