核心用法
dlazy-banana-pro 是一个封装了 dLazy Nano Banana Pro 图像生成能力的命令行工具技能。用户通过 dlazy banana-pro 命令调用,支持两种主要工作模式:
- 文生图(Text-to-Image):通过
--prompt参数提供文本描述生成图像 - 图生图(Image-to-Image):结合
--prompt和--images参数,基于现有图像进行编辑或重绘
关键参数包括宽高比(--aspectRatio,支持 1:1 到 21:9 多种比例)、分辨率(--imageSize,最高 4K)、以及输入方式(支持 JSON 内联、文件读取或标准输入)。工具采用 SaaS 架构,所有推理在 dLazy 云端完成,本地仅作为轻量客户端处理上传和结果获取。
认证与配置
需先通过 dlazy auth set YOUR_API_KEY 配置 API 密钥,密钥存储于用户目录下的 ~/.dlazy/config.json(类 Unix)或 %USERPROFILE%\.dlazy\config.json(Windows),权限限制为当前用户。也可通过 DLAZY_API_KEY 环境变量临时指定。
工作流特点
- 本地文件自动上传至
oss.dlazy.com供模型读取 - 生成结果以 URL 形式返回,托管于同一对象存储
- 支持
--dry-run预演模式估算成本 - 支持
--no-wait异步模式获取任务 ID
显著优点
1. 多模态灵活输入:同时支持纯文本生成和图像参考编辑,单张图生图场景覆盖常见创意需求
2. 输出规格丰富:内置 1K/2K/4K 三档分辨率与 6 种预设宽高比,无需手动计算像素
3. 轻量无依赖:基于 npm 生态,通过 npx 可零安装运行,不污染系统环境
4. 标准化 SaaS 流程:文件上传、推理、结果托管全链路由服务方管理,用户无需维护 GPU 或模型
5. 企业级密钥管理:支持随时轮换/吊销密钥,组织级权限隔离
潜在缺点与局限性
1. 网络强依赖:所有操作必须连接 dLazy 云服务,无法离线使用;上传大文件或生成高分辨率图像时受带宽和延迟制约
2. 闭源黑箱服务:模型架构、训练数据、安全过滤策略均未公开,可解释性和可控性有限
3. 单图限制:--images 参数当前最大仅支持 1 张参考图,复杂多图条件生成场景受限
4. 成本与配额:采用积分/余额制(insufficient_balance 错误码),高频使用需持续充值,无免费额度说明
5. 异步任务超时:默认 1800 秒等待上限,极端队列情况下可能超时失败
6. 平台锁定:生成结果 URL 托管于 dLazy 对象存储,长期可访问性依赖服务持续性
适合人群
- 设计师与内容创作者:需要快速产出概念图、产品图或视觉素材,对 4K 输出和固定比例有明确需求
- 开发者与自动化工作流构建者:希望通过 CLI 集成图像生成到 CI/CD、脚本批处理或内部工具链
- 轻量级用户:不愿配置复杂本地环境(如 Stable Diffusion WebUI、ComfyUI),偏好 "命令即服务" 模式
不适合:追求完全离线、可本地微调的隐私敏感场景;需要多图一致性生成或复杂工作流编排的专业 AI 艺术用户。
常规风险
1. 数据隐私:上传的本地图片发送至 oss.dlazy.com 云端存储,虽为临时处理性质,但仍存在传输和驻留风险,敏感内容需谨慎
2. 内容安全合规:后端存在 "Prompt violates safety policy" 类过滤机制,生成内容可能因不明规则被拦截,商业项目需预留备选方案
3. API 密钥泄露:密钥以明文形式存储于本地 JSON 文件,多用户共享设备或权限配置不当可能导致未授权使用
4. 服务连续性:依赖单一商业实体(dLazy),若服务调整定价、停止运营或区域限制,现有工作流将中断
5. 版权与授权模糊:生成图像的版权归属、商业使用授权范围未在文档中明示,企业商用需额外确认服务条款