运行时依赖
安装命令
点击复制技能文档
dlazy-recraft-v4-vector English · 中文 文本转矢量模型,输出 SVG 结果。适用于 logo、图标及可缩放设计资产。
触发关键词 recraft-v4-vector
认证 所有请求需 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),文件权限仅限当前 OS 用户。也可通过环境变量 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 recraft-v4-vector 获取结果
dlazy recraft-v4-vector -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-vector", "modelId": "recraft-v4-vector", "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-vector --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