dlazy-recraft-v4-pro

English · 中文

支持生成 400 万像素（4MP）高分辨率光栅图像，适用于印刷就绪资产及大规模使用场景。

触发关键词

• recraft-v4-pro

身份验证

所有请求均需提供 dLazy API 密钥。推荐的身份验证方式如下：

dlazy login

该命令将启动设备码认证流程（亦可在远程终端中正常运行），并自动将您的 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 密钥”区域中显示的密钥

每个密钥均绑定至您的 dLazy 组织，您可随时通过同一控制台界面轮换或撤销该密钥。

关于本工具与来源信息

• CLI 源代码: github.com/dlazyai/cli
• 维护者: dlazyai
• npm 包: @dlazy/cli（本技能安装规范中固定指定版本为 1.2.3）
• 官网: dlazy.com

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

npx @dlazy/cli@1.2.3 

或者，如您倾向全局安装，该技能的 metadata.clawdbot.install 字段已声明确切的锁定版本（即执行 npm install -g @dlazy/cli@1.2.3）。安装前请务必查阅 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 recraft-v4-pro 命令以获取结果。

dlazy recraft-v4-pro -h

Options:
  --prompt [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'

错误处理

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。