核心用法
dlazy-banana-pro 是 dLazy 平台 Nano Banana Pro 模型的命令行封装工具，专注于高质量图像生成与编辑。作为 SaaS 型技能，它将用户输入的提示词和参数发送至 dLazy 云端 API (api.dlazy.com) 进行推理，支持本地文件自动上传至 files.dlazy.com 供模型处理。
主要功能模式：
- 文生图 (Text-to-Image)：通过
--prompt描述生成全新图像 - 图生图 (Image-to-Image)：传入
--images参数对现有图像进行编辑或风格迁移
关键参数配置：
--aspectRatio：支持 1:1、4:3、16:9、9:16 等常见比例（默认 auto）--imageSize：输出分辨率可选 1K/2K/4K（默认 1K）--no-wait：异步模式，立即返回任务 ID 供后续轮询--dry-run：预演模式，仅打印请求体与费用估算
输出格式为标准 JSON，包含生成图像的 CDN 直链（https://files.dlazy.com），便于下游自动处理。
显著优点
1. 无缝认证体验：dlazy login 采用设备码流程，远程 SSH 环境亦可完成，自动本地存储 API 密钥，避免手动复制粘贴
2. 灵活的输入管道：支持 @N 引用上游输出、@stdin 管道、@* 批量处理等高级 CLI 模式
3. 分辨率覆盖广：最高支持 4K 输出，满足从社交媒体到印刷级的多场景需求
4. 异步任务支持：大模型推理耗时场景下，--no-wait 配合 dlazy status --wait 实现非阻塞工作流
5. npm 生态兼容：可通过 npx 零安装运行，亦支持全局安装，版本锁定明确（@1.2.0）
潜在缺点与局限性
| 维度 | 说明 |
|------|------|
| **完全依赖云端** | 无本地推理能力，必须联网且受 dLazy 服务可用性约束 |
| **按量计费门槛** | 需预购 Credits，余额不足（`insufficient_balance`）时任务中断 |
| **文件上传依赖** | 本地图像处理需先上传至 dLazy 服务器，敏感数据存在合规考量 |
| **异步状态管理** | 异步任务需自行轮询状态，CLI 未提供 Webhook 回调机制 |
| **开源但非自托管** | 代码开源（GitHub: `dlazyai/cli`），但模型与算力完全由 dLazy 托管，无法私有化部署 |
适合人群
- 内容创作者/设计师：快速生成概念图、产品 mockup、风格迁移素材
- 开发者/自动化工程师：需要将图像生成能力集成到 CI/CD 或批处理管道的场景
- 远程团队：利用设备码登录在容器/云服务器环境完成认证，无需图形界面
- 多平台用户：npm/npx 分发确保 Windows、macOS、Linux 一致体验
常规风险
- API 密钥泄露：存储于
~/.dlazy/config.json，权限虽限制为当前用户，但共享环境仍需警惕 - 数据出境合规：图像上传至
files.dlazy.com（境外域名），企业敏感素材需评估跨境传输政策 - 费用失控：高分辨率（4K）+ 批量生成消耗 Credits 较快，建议
--dry-run预演后再执行 - 内容安全拦截：提示词若违反平台安全策略，将返回
Generation Failed错误，无退款机制 - 供应商锁定：模型、存储、计费体系深度绑定 dLazy 生态，迁移成本较高