核心用法
dlazy videoseg 是一款命令行视频人像分割工具，通过调用 dLazy 托管的阿里云 SegmentVideoBody 异步 API，将输入视频中的人物主体与背景分离，生成与原视频时长相等的黑白蒙版（mask）视频，供下游合成或抠像流程使用。
主要特性
- 异步任务架构：默认同步等待结果，支持
--no-wait获取任务ID后脱机轮询 - 灵活输入：接受本地文件路径或 URL，自动上传至
files.dlazy.com - 管道兼容：支持
-、@N、@N.path、@*等引用语法，便于集成工作流 - 成本控制：
--dry-run可在调用前预览请求体与费用估算
认证机制
采用设备码流程（device-code flow）自动保存 API key 至 ~/.dlazy/config.json，无需手动复制粘贴；亦支持环境变量 DLAZY_API_KEY 或手动 dlazy auth set <key>。密钥可按组织粒度轮换或撤销。
显著优点
1. 云原生设计：无需本地 GPU，依赖阿里云视觉智能服务，分割质量由云厂商 SLA 保障
2. CLI 即用即走：通过 npx @dlazy/cli@1.2.0 零安装运行，或全局安装固定版本
3. 开源可审计：源码托管于 GitHub（github.com/dlazyai/cli），许可条款见仓库
潜在缺点与局限性
- 网络依赖：必须连通
api.dlazy.com与files.dlazy.com，离线不可用 - 账户门槛：需注册 dLazy 并持有有效 API key 与余额，余额不足时任务失败（错误码 503）
- 异步等待：默认超时 1800 秒，长视频可能需要更久或需手动轮询
- 黑盒后端：实际分割模型由阿里云托管，无法本地微调或离线推理
适合人群
- 视频创作者、VFX 后期人员需要快速生成人物遮罩
- 自动化工作流开发者（CI/CD、批处理脚本）
- 无本地算力但需稳定分割质量的个人或小型团队
常规风险
- 凭证泄露：API key 存储于本地 JSON 文件，多用户环境需检查
~/.dlazy权限 - 数据出境：原始视频上传至 dLazy/阿里云，敏感内容需评估合规性
- 费用不可控：异步任务失败仍可能计费，建议始终使用
--dry-run预估 - 供应商锁定：API 与存储端点固定，迁移成本较高