| name | pixabay-footage |
| description | Search and download copyright-free images and video clips from Pixabay API. Alternative to pexels-footage when Pexels has no suitable results. Supports both photo search (--type image) and video search (--type video, default). |
| metadata | {"openclaw":{"emoji":"🎬","requires":{"bins":["python3"],"env":["PIXABAY_API_KEY"]}}} |
Pixabay Footage — Pexels 之外的备选图片/视频素材
Use this skill when:
- Pexels results are not suitable or quota is exhausted
- You need alternative copyright-free images or video clips
- Preparing visual assets for content creation
Prerequisites: PIXABAY_API_KEY must be set. Register free at https://pixabay.com/api/docs/
📍 全局技能路径提示：文中所有 ./scripts/ 路径均相对于本技能所在目录（即 <skill> 标签 location 属性所指目录），不是工作区目录。执行时按本技能实际安装路径拼接。
Usage
下载图片
python3 ./scripts/pixabay_search.py \
--type image \
--terms "sunset,ocean,forest" \
--aspect 16:9 \
--output-dir ./assets/images \
[--max-clips 15]
下载视频
python3 ./scripts/pixabay_search.py \
--type video \
--terms "sunset,ocean" \
--aspect 9:16 \
--output-dir ./video_assets/footage \
--min-duration 5 \
--max-duration 30
重要：视频下载一次只允许下载一个（脚本已强制 --max-clips=1），不允许批量下载。下载时应根据 content-check 报告的时长缺口，通过 --min-duration 和 --max-duration 精确匹配所需时长，不要下载远超需求的素材。
Same interface as pexels-footage. Output format identical.
When to Choose Pixabay vs Pexels
| Pixabay | Pexels |
|---|
| Photo quality | Good | High |
| Photo count | 4M+ | 3M+ |
| Video quality | Good (HD) | Higher (HD/4K) |
| Video count | 2M+ | 1M+ |
| Rate limits | 100 req/min (free) | 200 req/hour (free) |
| Best for | Objects, abstract, concepts | People, nature, lifestyle |
Pexels is the primary footage source (higher quality). Fall back to Pixabay if Pexels results are insufficient or rate-limited.
Options
| Option | Default | Description |
|---|
--terms | required | Comma-separated search keywords (one per scene) |
--type | video | image or video |
--aspect | 9:16 | 9:16 (portrait) | 16:9 (landscape) | 1:1 (square) |
--output-dir | required | Directory to save downloaded files |
--min-duration | 5 | Minimum clip duration in seconds (video only) |
--max-duration | none | Maximum clip duration in seconds (video only). 强烈建议设置，避免下载过长的素材 |
--max-clips | 1 (video) / 15 (image) | Maximum total files to download. 视频类型强制为 1 |
Output
Same JSON structure as pexels-footage:
--type image → {"ok": true, "images": [...], "total": N, "output_dir": "..."}--type video → {"ok": true, "clips": [...], "total": N, "output_dir": "..."}
Environment Variables
| Variable | Description |
|---|
PIXABAY_API_KEY | Pixabay API key (required) |
