核心用法
dlazy-search-video 是一款命令行视频素材检索工具,通过封装 Pixabay 免费视频 API,为用户提供关键词搜索、分类筛选、时长过滤等功能。使用时需先通过 dlazy login 完成设备码授权,API 密钥自动保存至本地配置文件;也可手动设置 DLAZY_API_KEY 环境变量或执行 dlazy auth set <key>。基础调用格式为 dlazy search_video --query <关键词>,支持 --videoType(film/animation/all)、--category(20+ 类目)、--minDuration/--maxDuration 等精细过滤,结果以 JSON 格式返回视频 URL 及元数据。
显著优点
1. 正版免费素材:直接对接 Pixabay 庞大库存,所有视频均可商用免版权费。
2. 筛选维度丰富:涵盖视频类型、内容分类、时长区间,便于精准定位。
3. CLI 即装即用:支持 npx 零安装运行或全局安装,适配 CI/CD 自动化流程。
4. 异步任务支持:--no-wait 模式适合批量检索场景,避免阻塞。
5. 设备码流登录:远程服务器环境也能安全授权,无需浏览器复制粘贴。
潜在缺点与局限
- 依赖第三方服务:Pixabay API 可用性、速率限制及内容更新不受本工具控制。
- 账户余额机制:dLazy 平台采用积分制,余额不足(
insufficient_balance)时将无法调用,需额外充值。 - 网络与隐私:搜索关键词及本地文件路径需上传至
api.dlazy.com与files.dlazy.com,存在数据出境风险。 - 功能单一:仅支持搜索与元数据返回,无预览、剪辑或下载管理功能。
- 版本锁定:技能指定 CLI 版本 1.2.0/1.2.1,若上游 API 变更可能存在兼容性滞后。
适合人群
- 短视频创作者、自媒体运营者需快速获取免费 B-roll
- 前端开发者/设计师在原型阶段嵌入占位视频
- 营销团队批量检索特定主题素材用于广告投放
- 教育行业制作课件需正版免版权视频片段
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 账户安全 | API 密钥存储于本地明文 JSON,虽设 OS 级权限但仍可能被恶意读取 | 定期轮换密钥,避免在共享环境保存密钥 |
| 服务中断 | dLazy 或 Pixabay 服务故障导致搜索失败 | 关键项目应本地备份常用素材 |
| 内容合规 | Pixabay 素材虽免版税,但部分视频可能含人物肖像、商标,商用需二次确认 | 高风险场景建议购买保险或咨询法务 |
| 隐私泄露 | 搜索关键词可能暴露业务方向 | 避免搜索敏感内部项目关键词 |