核心用法
dlazy-gemini-3.1 是一个命令行封装工具，通过 dLazy 托管的 API 调用 Google Gemini 3.1 多模态大模型。用户通过 dlazy gemini-3.1 命令并配合 --prompt 参数发起请求，可选传入本地或远程的图像（最多10张）和视频（最多8条）进行多模态分析。支持 --dry-run 预估算成本、--no-wait 异步任务模式，以及通过管道引用（如 -、@N、@stdin）处理上游输入。
认证采用设备码流程（dlazy login）自动保存 API key 到 ~/.dlazy/config.json，也可通过环境变量 DLAZY_API_KEY 或手动设置。API key 与 dLazy 组织账户绑定，可在后台随时轮换或吊销。
显著优点
1. 原生多模态能力：Gemini 3.1 在视觉理解、视频分析和长文档解析方面表现突出，支持复杂图文混合任务。
2. 长上下文窗口：适合处理大型文档、长视频内容理解与跨模态信息整合。
3. 结构化输出：API 返回标准 JSON 格式，便于下游程序解析和自动化处理。
4. 灵活的执行模式：支持同步等待和异步轮询两种模式，适应不同场景的性能需求。
5. 便捷的 CLI 体验：npx 即用即走，无需全局安装；管道引用机制与上游工具链集成顺畅。
潜在缺点与局限性
1. 第三方托管依赖：实际推理由 dLazy 平台而非 Google 官方 API 直接提供，服务可用性、数据隐私条款受 dLazy 控制，存在 vendor lock-in 风险。
2. 闭源后端：dLazy 的 API 实现、模型版本管理、数据留存策略不透明，企业敏感数据处理需谨慎评估。
3. 账户体系耦合：必须注册 dLazy 账户并预充值余额，无法直接使用 Google Cloud 凭据或按量计费。
4. 错误码体系混杂：CLI 前端错误（501/502）与后端 API 错误（401/503/504）混合，排查时需区分层级。
5. 网络与地域限制：依赖 api.dlazy.com 和 files.dlazy.com，部分地区可能存在访问稳定性问题。
适合人群
- 需要快速集成 Gemini 多模态能力但不愿自行部署基础设施的开发者
- 处理图文、视频混合内容的内容创作者与数据分析师
- 构建文档理解、媒体分析自动化流程的中小团队
- 已采用 dLazy 生态、希望统一账单和权限管理的用户
常规风险
| 风险类别 | 说明 |
|---------|------|
| **账户安全** | API key 存储于本地 JSON 文件，虽受 OS 权限保护，但在共享环境或 CI 场景中需配合环境变量使用 |
| **余额耗尽** | 异步任务可能因余额不足失败，需前置检查或建立余额监控 |
| **内容合规** | 后端可能因安全策略拒绝生成（如 504 错误），涉及敏感内容时需准备降级方案 |
| **数据出境** | 文件上传至 dLazy 媒体存储，跨境数据合规需确认服务商数据中心位置 |
| **供应链** | npm 包 `@dlazy/cli` 的更新策略、版本锁定与 GitHub 源码一致性需定期审计 |