核心用法
dlazy-videoseg 是一款基于阿里云 SegmentVideoBody 服务的视频人像分割工具。用户通过 CLI 调用，上传视频后，服务异步处理并返回与源视频等长的黑白遮罩视频（mask），其中白色区域表示人物，黑色表示背景。
典型调用流程
# 先登录获取 API key dlazy login # 执行分割任务 dlazy videoseg --video ./input.mp4 # 或使用 --no-wait 获取任务 ID 后异步轮询 dlazy videoseg --video ./input.mp4 --no-wait dlazy status <generateId> --wait
关键参数
| 参数 | 说明 |
|------|------|
| `--video` | 输入视频（URL 或本地路径，支持管道引用） |
| `--dry-run` | 预览请求体与费用估算，不实际调用 |
| `--no-wait` | 立即返回异步任务 ID |
| `--timeout` | 等待完成的超时时间（默认 1800 秒） |
输出格式为 JSON，包含 result.outputs 数组，其中 url 指向 files.dlazy.com 托管的遮罩视频文件。
---
显著优点
1. 云端异步处理：基于阿里云成熟的人像分割能力，可处理长视频而不占用本地算力
2. 等长输出：生成的遮罩视频与输入严格时序对齐，便于直接叠加合成
3. CLI 集成友好：支持管道操作（@N、@stdin 等），便于嵌入自动化工作流
4. 无手动密钥管理：dlazy login 采用 device-code 流程，自动安全存储 API key
---
潜在缺点与局限性
| 局限 | 说明 |
|------|------|
服务依赖 | 完全依赖 dLazy 云服务与阿里云后端，离线不可用 |
| **费用模型** | 按调用计费，需监控余额（错误码 503 触发充值引导） |
| **黑白单通道** | 仅输出硬遮罩，无 alpha 透明度或边缘羽化参数可调 |
| **无实时预览** | 异步模式需轮询，实时性取决于队列长度 |
| **版本锁定** | 技能绑定 `@dlazy/cli@1.2.0`，需关注上游兼容性 |
---
适合人群
- 短视频创作者：需要快速提取人像进行背景替换或特效合成
- 自动化运维工程师：构建批处理视频处理 pipeline
- 电商/直播团队：批量生成绿幕效果，降低实拍成本
- 开发者：需要通过 CLI 工具链集成视频分割能力的项目
---
常规风险
1. 数据出境与隐私：视频上传至 files.dlazy.com 与阿里云，涉及敏感内容需确认合规性
2. API 密钥泄露：存储于 ~/.dlazy/config.json，共享环境需确保文件权限（0600）
3. 任务失败成本：异步任务可能因"安全策略违规"失败，已扣费部分可能不退
4. 供应商锁定：遮罩质量完全取决于阿里云模型迭代，无本地 fallback 方案
5. 网络中断风险：长视频上传/下载对大文件稳定性有要求，建议配合 --timeout 使用