免费资源

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

快速开始

# 1. 复制配置模板，并填入您的 API 密钥
cp config.example.json config.json

# 2. 编辑 config.json，填入您的 API 密钥

# 3. 不传入 API 密钥直接使用
bun ./scripts/jamendo.ts search --query "background" --limit 5
bun ./scripts/freesound.ts search --query "piano"
bun ./scripts/pexels.ts search-photos --query "nature"
bun ./scripts/pexels.ts search-videos --query "ocean waves"
bun ./scripts/pixabay.ts search-images --query "nature"

配置

API 密钥保存在 config.json 中。请先复制 config.example.json 并填入您的密钥：

{
  "pexels": {
    "api_key": "YOUR_PEXELS_API_KEY"
  },
  "pixabay": {
    "api_key": "YOUR_PIXABAY_API_KEY"
  },
  "freesound": {
    "api_token": "YOUR_FREESOUND_TOKEN"
  },
  "jamendo": {
    "client_id": "YOUR_JAMENDO_CLIENT_ID"
  }
}

获取 API 密钥

API 密钥优先级

1. CLI 参数：--key、--token 或 --client-id
2. 环境变量：PEXELS_API_KEY、PIXABAY_API_KEY、FREESOUND_API_TOKEN、JAMENDO_CLIENT_ID
3. 配置文件：config.json

Pexels（照片与视频）

搜索照片

bun ./scripts/pexels.ts search-photos --query "city skyline" --orientation landscape --per-page 5

可用参数：--query、--orientation（landscape|portrait|square）、--size（large|medium|small）、--color、--locale、--page、--per-page（1–80）、--output（保存至文件）。

搜索视频

bun ./scripts/pexels.ts search-videos --query "ocean waves" --orientation landscape --size medium --per-page 5

可用参数：--query、--orientation（landscape|portrait|square）、--size（large|medium|small）、--locale、--page、--per-page（1–80）、--output。

下载

bun ./scripts/pexels.ts download --url "https://images.pexels.com/..." --output "/path/to/save.jpg"

如条件允许，请始终注明 Pexels 及创作者署名。

Pixabay（图片与视频）

搜索图片

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（保存至文件）。

搜索视频

bun ./scripts/pixabay.ts search-videos --query "ocean waves" --video-type film --per-page 5

下载

bun ./scripts/pixabay.ts download --url "https://pixabay.com/get/..." --output "/path/to/save.jpg"

Freesound（音效）

搜索音效

bun ./scripts/freesound.ts search --query "piano note" --page-size 10

可用参数：--query、--filter、--sort、--fields、--page、--page-size（最大 150）、--group-by-pack、--output。

筛选示例

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

获取音效详情

bun ./scripts/freesound.ts get --id 12345 --fields id,name,previews,duration

下载预览音频

bun ./scripts/freesound.ts download --id 12345 --output ./sound.mp3

Jamendo（音乐与 BGM）

搜索音乐

bun ./scripts/jamendo.ts search --query "rock" --limit 10

可用参数：--query、--tags、--fuzzytags、--artist-name、--album-name、--order、--limit（最大 200）、--offset、--output。

音乐属性筛选

# 纯器乐背景音乐
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

获取音轨详情

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

下载音轨

bun ./scripts/jamendo.ts download --id 12345 --output ./music.mp3

API 参考文档

完整参数表、响应字段说明及速率限制详情，请参阅 ./references/api_reference.md。