CtrlK
BlogDocsLog inGet started
Tessl Logo

pixabay-footage

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).

69

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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/


Usage

通过 PATH 调用 wrapper,无需拼接脚本路径。

下载图片

pixabay-footage \
  --type image \
  --terms "sunset,ocean,forest" \
  --aspect 16:9 \
  --output-dir ./assets/images \
  [--max-clips 15]

下载视频

pixabay-footage \
  --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

PixabayPexels
Photo qualityGoodHigh
Photo count4M+3M+
Video qualityGood (HD)Higher (HD/4K)
Video count2M+1M+
Rate limits100 req/min (free)200 req/hour (free)
Best forObjects, abstract, conceptsPeople, nature, lifestyle

Pexels is the primary footage source (higher quality). Fall back to Pixabay if Pexels results are insufficient or rate-limited.


Options

OptionDefaultDescription
--termsrequiredComma-separated search keywords (one per scene)
--typevideoimage or video
--aspect9:169:16 (portrait) | 16:9 (landscape) | 1:1 (square)
--output-dirrequiredDirectory to save downloaded files
--min-duration5Minimum clip duration in seconds (video only)
--max-durationnoneMaximum clip duration in seconds (video only). 强烈建议设置,避免下载过长的素材
--max-clips1 (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

VariableDescription
PIXABAY_API_KEYPixabay API key (required)
Repository
TeamWiseFlow/xiaobei
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.