by 运行时依赖
安装命令
点击复制技能文档
dlazy-recraft-v4 英語 · 中文 1MP 光栅图像生成，具有精细的设计判断。适合日常创作工作和快速迭代。 触发关键词 recraft-v4 身份验证 所有请求都需要 dLazy API 密钥。推荐的身份验证方式是： dlazy 登录 这会运行设备代码流（也适用于远程 shell），并自动将您的 API 密钥保存到本地 CLI 配置中 — 无需手动复制和粘贴。 替代方法：手动设置密钥 如果您已经有一个 API 密钥，可以直接保存： dlazy auth set YOUR_API_KEY CLI 将密钥保存在您的用户配置目录中（macOS/Linux 上为 ~/.dlazy/config.json，Windows 上为 %USERPROFILE%\.dlazy\config.json），并将文件权限限制为您的操作系统用户帐户。您也可以通过 DLAZY_API_KEY 环境变量在每次调用时提供密钥。 手动获取 API 密钥 登录或在 dlazy.com 创建一个帐户 前往 dlazy.com/dashboard/organization/api-key 复制 API 密钥部分显示的密钥 每个密钥都针对您的 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 的薄客户端。当您调用它时： 您提供的提示和参数将发送到 dLazy API 端点（api.dlazy.com）进行推理。 您传递给图像/视频/音频字段的任何本地文件路径都将上传到 dLazy 的媒体存储（files.dlazy.com），以便模型可以读取它们 — 与任何基于云的生成 API 的相同流程。 由 API 返回的生成输出 URL 将托管在 files.dlazy.com 上。这是标准的 SaaS 模式；技能本身不会访问超出 dLazy CLI 已经处理的网络或文件系统资源。请参阅 dlazy.com 以获取完整的服务条款。 使用方法 CRITICAL 指令 FOR AGENT：执行 dlazy recraft-v4 以获取结果。 dlazy recraft-v4 -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", "modelId": "recraft-v4", "outputs": [ { "type": "image", "id": "o_xxxxxxxx", "url": "https://files.dlazy.com/result.png", "mimeType": "image/png" } ] } } 异步任务（当传递 --no-wait 时）返回输出：[] 和任务：{ generateId, status } 字段。使用 dlazy status --wait 进行轮询。 示例 dlazy recraft-v4 --prompt '提示内容' 错误处理 代码 错误类型 示例消息 401 未经授权（无 API 密钥） ok：false, 代码：“未经授权”，消息：“API 密钥丢失或无效” 501 缺少必需参数 错误：必需选项 '--prompt ' 未指定 502 本地文件读取错误 错误：图像文件/视频文件未找到：C:\path\to\your\file 503 API 请求失败（无余额） ok：false, 代码：“余额不足” 503 API 请求失败（服务器错误） HTTP 状态代码错误（服务器崩溃） 504 异步任务执行失败 === 生成失败 === / {后端返回的特定错误原因，例如“提示违反安全策略”} AGENT CRITICAL 指令：如果执行结果返回代码：“余额不足”，您必须明确告知用户他们的积分不足，并指导他们前往 https://dlazy.com/dashboard/organization/settings?tab=credits 充值。如果执行结果返回代码：“未经授权”或指示缺少 API 密钥，您必须告知用户从 https://dlazy.com/dashboard/organization/api-key 获取他们的 API 密钥，并使用 dlazy auth set 保存，然后重新执行任务。 提示 请访问 https://dlazy.com 以获取更多信息。