核心用法
dlazy-search_video 是一款基于 dLazy 托管 API 的命令行视频搜索工具，底层对接 Pixabay 视频库。用户通过 dlazy search_video --query "关键词" 即可发起搜索，支持 20 余种垂直分类（自然、商业、科技、旅行等）、视频类型（实拍/动画）及自定义时长区间过滤。结果以结构化 JSON 返回，包含视频直链、缩略图、分辨率、时长、作者授权信息等元数据，便于直接嵌入剪辑流程或批量下载。
显著优点
- 即搜即用：无需注册 Pixabay 账号，统一通过 dLazy API 密钥调用，降低多平台管理成本。
- 灵活过滤：支持
minDuration/maxDuration精确筛选素材长度，--dry-run可预估消耗避免浪费。 - 异步友好：
--no-wait模式返回任务 ID，适合长耗时搜索场景，配合dlazy status轮询结果。 - 管道兼容：支持
@N、@stdin等引用语法，便于串联上游 AI 生成结果进行自动化素材匹配。
潜在缺点与局限性
- 商业依赖：完全依赖 dLazy 云服务，若 API 故障或余额不足（
insufficient_balance）则无法使用，无离线缓存机制。 - 版权盲区：Pixabay 素材虽标注免版税，但实际商用仍需二次核对授权范围（如是否含 recognizable faces、trademark 等），工具本身不提供合规审查。
- 版本锁定：CLI 版本固定为
1.2.0，若上游 Pixabay API 变更而 dLazy 未及时同步，可能导致搜索失效。 - 隐私顾虑：搜索关键词及本地文件路径需上传至
api.dlazy.com，敏感内容存在云端留痕风险。
适合人群
- 短视频创作者、营销团队需快速获取免版税素材片段
- 自动化剪辑工作流开发者，需通过 CLI 批量检索视频元数据
- 教育机构制作课件，需筛选特定主题（科学、教育、自然）的合规素材
常规风险
| 风险类型 | 说明 |
|---------|------|
| **账户安全** | API 密钥以明文形式存储于 `~/.dlazy/config.json`，需确保文件权限严格限制（OS user-only）。 |
| **余额耗尽** | 搜索按次计费，余额不足时返回 503 错误，需及时充值避免 workflow 中断。 |
| **内容合规** | Pixabay 素材仍可能包含需额外授权的元素（如人物肖像、品牌标识），商用前建议法律审核。 |
| **服务中断** | 完全云端架构，网络波动或 dLazy 服务端故障将直接导致工具不可用。 |