核心用法
dlazy-recraft-v4-pro-vector 是一个基于云 API 的文本转矢量图像生成工具，通过 CLI 调用 dLazy 托管的 Recraft V4 Pro 模型。用户只需提供文本提示词（prompt），即可生成 4MP 级别的高质量矢量图像，输出格式为 PNG（通过 URL 返回）。
基础调用：
dlazy recraft-v4-pro-vector --prompt "your prompt here"
主要参数：
--prompt: 生成提示词（必填）--aspect_ratio: 宽高比（支持 1:1、4:3、16:9 等 10 种预设，默认 auto）--dry-run: 预览请求载荷和费用估算，不实际调用 API--no-wait: 异步模式，立即返回 task ID 供后续轮询--timeout: 异步任务最大等待时间（默认 1800 秒）
认证方式：
- 首选：
dlazy login执行设备码流程，自动保存 API key - 手动：
dlazy auth set YOUR_API_KEY写入配置文件 - 环境变量：
DLAZY_API_KEY临时注入
API key 存储于 ~/.dlazy/config.json，权限限制为当前 OS 用户。
显著优点
1. 生产级输出质量：4MP 分辨率 + 矢量模型，适合印刷、品牌物料、UI 图标等精细场景
2. 专业宽高比控制：10 种预设比例，覆盖社交媒体、海报、横幅等常见尺寸
3. 灵活的异步支持：--no-wait + dlazy status --wait 适合批量任务和 CI/CD 集成
4. 成本透明化：--dry-run 可在调用前确认费用，避免意外扣款
5. 零本地依赖：纯 CLI 工具，无需 GPU 或本地模型，降低硬件门槛
6. 管道友好：支持 stdin 引用（-、@N、@stdin:path 等），便于脚本链式调用
潜在缺点与局限性
1. 商业成本门槛：按调用计费，高频使用需持续购买 credits，无免费额度说明
2. 网络依赖严格：所有计算在云端完成，离线无法使用，上传下载受带宽影响
3. 输出格式限制：API 返回 PNG 位图 URL，非原生 SVG 路径数据（需确认是否为矢量转栅格）
4. 账号体系封闭：必须使用 dLazy 平台账号，无第三方 OAuth 或企业 SSO 选项
5. 错误处理分散：余额不足、鉴权失败、内容安全拦截等错误码分散，需前端显式处理
6. 版本锁定风险：CLI 固定 pinned 至 1.2.0/1.0.9，后续版本兼容性需人工验证
适合人群
- UI/UX 设计师：快速生成图标、插画素材，保持品牌视觉一致性
- 品牌/marketing 团队：批量产出社交媒体配图、海报原图
- 开发者/自动化工程师：集成至内容生成流水线，通过
--no-wait实现异步批处理 - 内容创作者：需要高清矢量风格图像但无专业绘图技能
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| **账号/密钥泄露** | API key 存储于本地 JSON，多用户系统可能存在权限绕过 | 使用 `DLAZY_API_KEY` 环境变量替代文件存储；定期轮转 key |
| **费用失控** | 无调用上限或预算告警机制 | 先用 `--dry-run` 估算成本；监控 dashboard 余额 |
| **内容合规风险** | 提示词可能触发安全策略导致生成失败 | 避免敏感、侵权描述；参考平台内容政策 |
| **服务可用性** | 依赖 dLazy 云服务 SLA，无本地降级方案 | 关键任务保留备用方案；异步任务设置合理 timeout |
| **数据驻留** | 上传文件存储于 `files.dlazy.com`，需确认数据主权条款 | 审查 [dlazy.com](https://dlazy.com) 服务条款；敏感素材脱敏处理 |
安全等级说明：CLI 本身为 thin client，无特权操作，但涉及云端 API 密钥管理和文件上传，需关注密钥存储与传输安全。来源为 GitHub 开源仓库 + npm 官方渠道，可信度较高。