免费资源

从Pixabay、Freesound和Jamendo搜索并下载免版税图片、视频、音效和音乐。

快速开始

bash

1. 复制配置模板并填写你的API密钥

2. 使用你的API密钥编辑config.json

3. 无需传递API密钥即可使用

配置

API密钥存储在config.json中。复制config.example.json并填写你的密钥：

json
{
pixabay: {
apikey: 你的PIXABAYAPI_KEY
},
freesound: {
apitoken: 你的FREESOUNDTOKEN
},
jamendo: {
clientid: 你的JAMENDOCLIENT_ID
}
}

获取API密钥

API密钥优先级

1. 1. CLI标志：--key、--token或--client-id
2. 环境变量：PIXABAYAPIKEY、FREESOUNDAPITOKEN、JAMENDOCLIENTID
3. 配置文件：config.json

Pixabay（图片和视频）

搜索图片

bash
bun ./scripts/pixabay.ts search-images --query 黄色花朵 --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 海浪 --video-type film --per-page 5

下载

bash
bun ./scripts/pixabay.ts download --url https://pixabay.com/get/... --output /保存路径/图片.jpg

Freesound（音效）

搜索声音

bash
bun ./scripts/freesound.ts search --query 钢琴音符 --page-size 10

标志：--query、--filter、--sort、--fields、--page、--page-size（最大150）、--group-by-pack、--output。

筛选示例

bash
bun ./scripts/freesound.ts search --query 鼓 --filter duration:[0 TO 2]
bun ./scripts/freesound.ts search --query 环境 --filter type:wav
bun ./scripts/freesound.ts search --query 爆炸 --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 ./声音.mp3

Jamendo（音乐和BGM）

搜索音乐

bash
bun ./scripts/jamendo.ts search --query 摇滚 --limit 10

标志：--query、--tags、--fuzzytags、--artist-name、--album-name、--order、--limit（最大200）、--offset、--output。

音乐属性筛选

bash

器乐背景音乐

按标签搜索（AND逻辑）

按速度搜索

获取曲目详情

bash
bun ./scripts/jamendo.ts track --id 12345 --include musicinfo,stats

下载曲目

bash
bun ./scripts/jamendo.ts download --id 12345 --output ./音乐.mp3

API参考

有关完整的参数表、响应字段描述和速率限制详情，请参阅./references/api_reference.md。