by 运行时依赖
安装命令
点击复制技能文档
dlazy-recraft-v4-pro 英文 · 中文 4MP 高分辨率栅格图像生成，适用于印刷级素材及大尺寸用途。
触发关键词 recraft-v4-pro
认证 所有请求需 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 进行推理。
- 本地传入的 image / video / audio 文件路径将上传至 dLazy 媒体存储 files.dlazy.com，供模型读取——与任何云端生成 API 流程一致。
- 生成的输出 URL 由 files.dlazy.com 托管。
用法 关键指令：执行 dlazy recraft-v4-pro 获取结果。
dlazy recraft-v4-pro -h
选项： --prompt [prompt] 提示词 --aspect_ratio [aspect_ratio] 画幅比例 [默认: auto]（可选："auto","1:1","4:3","3:4","16:9","9:16","3:2","2:3","2:1","1:2"） --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": "recraft-v4-pro", "modelId": "recraft-v4-pro", "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 recraft-v4-pro --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 获取密钥，并用 dlazy auth set 保存后继续任务。
更多帮助 访问 https://dlazy.com