by 详细分析 ▾
运行时依赖
版本
首次发布：从多个来源搜索并下载免版权媒体。 - 支持 Pixabay 图片与视频、Freesound 音效及 Jamendo 音乐/BGM。 - 提供 CLI 脚本，可在三大平台搜索、过滤并下载内容。 - 灵活的 API 密钥管理：CLI 标志、环境变量或配置文件。 - 文档含使用示例与各媒体类型的过滤选项。 - 包含完整 API 参考以供高级查询。
安装命令
点击复制技能文档
# 免费资源 从 Pixabay、Freesound 与 Jamendo 搜索并下载免版税的图片、视频、音效与音乐。 ## 快速开始 ``bash # 1. 复制配置模板并填入你的 API 密钥 cp config.example.json config.json # 2. 编辑 config.json 填入你的 API 密钥 # 3. 无需显式传 key 即可使用 bun ./scripts/jamendo.ts search --query "background" --limit 5 bun ./scripts/freesound.ts search --query "piano" bun ./scripts/pixabay.ts search-images --query "nature" ` ## 配置 将 API 密钥保存在 config.json。复制 config.example.json 并填入： `json { "pixabay": { "api_key": "YOUR_PIXABAY_API_KEY" }, "freesound": { "api_token": "YOUR_FREESOUND_TOKEN" }, "jamendo": { "client_id": "YOUR_JAMENDO_CLIENT_ID" } } ` ### 获取 API 密钥 | 平台 | 类型 | 获取地址 | |----------|------|-------------| | Pixabay | 图片/视频 | https://pixabay.com/accounts/register/ | | Freesound | 音效 | https://freesound.org/apiv2/apply | | Jamendo | 音乐/BGM | https://devportal.jamendo.com/ | ### API 密钥优先级 1. CLI 参数：--key、--token 或 --client-id 2. 环境变量：PIXABAY_API_KEY、FREESOUND_API_TOKEN、JAMENDO_CLIENT_ID 3. 配置文件：config.json --- ## Pixabay（图片与视频） ### 搜索图片 `bash bun ./scripts/pixabay.ts search-images --query "yellow flowers" --image-type photo --orientation horizontal --per-page 5 ` 可用参数：--query、--id、--lang、--image-type（all|photo|illustration|vector）、--orientation（all|horizontal|vertical）、--category、--colors（逗号分隔）、--min-width、--min-height、--editors-choice、--safesearch、--order（popular|latest）、--page、--per-page（5-200）、--output（保存到文件）。 ### 搜索视频 `bash bun ./scripts/pixabay.ts search-videos --query "ocean waves" --video-type film --per-page 5 ` ### 下载 `bash bun ./scripts/pixabay.ts download --url "https://pixabay.com/get/..." --output "/path/to/save.jpg" ` --- ## Freesound（音效） ### 搜索音效 `bash bun ./scripts/freesound.ts search --query "piano note" --page-size 10 ` 可用参数：--query、--filter、--sort、--fields、--page、--page-size（最大 150）、--group-by-pack、--output。 ### 过滤示例 `bash bun ./scripts/freesound.ts search --query "drum" --filter "duration:[0 TO 2]" bun ./scripts/freesound.ts search --query "ambient" --filter "type:wav" bun ./scripts/freesound.ts search --query "explosion" --sort downloads_desc ` ### 获取音效详情 `bash bun ./scripts/freesound.ts get --id 12345 --fields id,name,previews,duration ` ### 下载预览 `bash bun ./scripts/freesound.ts download --id 12345 --output ./sound.mp3 ` --- ## Jamendo（音乐与 BGM） ### 搜索音乐 `bash bun ./scripts/jamendo.ts search --query "rock" --limit 10 ` 可用参数：--query、--tags、--fuzzytags、--artist-name、--album-name、--order、--limit（最大 200）、--offset、--output。 ### 音乐属性过滤 `bash # 纯音乐背景乐 bun ./scripts/jamendo.ts search --query "background" --vocalinstrumental instrumental # 按标签搜索（AND 逻辑） bun ./scripts/jamendo.ts search --tags "electronic+chill" --order popularity_total_desc # 按速度搜索 bun ./scripts/jamendo.ts search --query "energetic" --speed high+veryhigh ` ### 获取曲目详情 `bash bun ./scripts/jamendo.ts track --id 12345 --include musicinfo,stats ` ### 下载曲目 `bash bun ./scripts/jamendo.ts download --id 12345 --output ./music.mp3 ` --- ## API 参考 完整参数表、返回字段说明及速率限制详见 ./references/api_reference.md`。