Lots of Sounds

免费音效 API

一个公开、无需密钥的 API，用于搜索和试听精选免费音效。由 Lots of Sounds 为应用、游戏、视频、自动化和 AI Agent 打造。

• 样例列表和样例流无需 API 密钥
• 结构化 JSON，包含 ID、描述、标签和时长
• 样例集合中的音效采用 CC0 协议
• 本仓库不存储音频二进制文件

正在寻找维护中的 Freesound API 替代方案？先使用下方的免费样例端点；需要目录搜索、筛选和下载时，再使用完整的 Lots of Sounds API。

快速开始

curl -G "https://api.lotsofsounds.com/api/v1/sounds/sample" \
  --data-urlencode "q=door knock" \
  --data-urlencode "limit=6"

无需账号或 API 密钥。响应最多包含 12 个精选样例：

{
  "data": [
    {
      "id": "fs-133889",
      "name": "Large Wood Door Knocking",
      "description": "Knocking on a door to a large entry",
      "tags": ["door", "knocking", "wood"],
      "duration": 2.86766,
      "stream_url": "/api/v1/sounds/sample/fs-133889/stream"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 6,
    "total": 6,
    "totalPages": 1
  }
}

此示例经过了缩略；随着精选样例集不断完善，字段和匹配结果可能会发生变化。

免费端点

方法	端点	身份验证	用途
GET	/api/v1/sounds/sample	无	列出或搜索精选样例
GET	/api/v1/sounds/sample/{id}/stream	无	获取临时流式 URL

搜索样例

使用 q 进行文本查询，或使用 tags 指定逗号分隔的标签。limit 接受 1 到 12 之间的值。

curl -G "https://api.lotsofsounds.com/api/v1/sounds/sample" \
  --data-urlencode "tags=door,knock" \
  --data-urlencode "limit=6"

播放样例流

使用音效返回的相对路径 stream_url：

curl "https://api.lotsofsounds.com/api/v1/sounds/sample/fs-133889/stream"

此端点会返回包含限时 stream_url 的 JSON；它不会将 MP3 放入本仓库。

JavaScript

需要 Node.js 18 或更高版本。

const params = new URLSearchParams({ q: "notification", limit: "6" });
const response = await fetch(
  `https://api.lotsofsounds.com/api/v1/sounds/sample?${params}`,
);

if (!response.ok) {
  throw new Error(`Lots of Sounds returned HTTP ${response.status}`);
}

const { data } = await response.json();
console.log(data);

运行完整的无依赖示例：

node examples/javascript.mjs "notification"

如需支持身份验证搜索、元数据和下载的类型化客户端，请参阅 lotsofsounds/sound-effects-api-js。

Python

随附示例仅使用 Python 标准库：

git clone https://github.com/lotsofsounds/free-sound-effects-api.git
cd free-sound-effects-api
python3 examples/python.py "notification"

或者直接使用 requests：

import requests

response = requests.get(
    "https://api.lotsofsounds.com/api/v1/sounds/sample",
    params={"q": "notification", "limit": 6},
    timeout=20,
)
response.raise_for_status()
print(response.json()["data"])

AI Agent

Agent 技能

本仓库包含一个无依赖的 find-free-sound-effects 技能。将该目录复制到 Agent 的技能目录，或让 Agent 使用已检出的仓库。

请求示例：

为 AI 助手查找一段简短、舒缓的通知音效。

该技能会搜索免费端点、比较元数据，并为选定的样例请求临时流式 URL。

MCP 服务

Lots of Sounds 还提供托管的 Model Context Protocol 服务：

claude mcp add lotsofsounds --transport http https://api.lotsofsounds.com/mcp

browse_samples MCP 工具无需身份验证即可使用。完整目录工具需要 API 密钥：

claude mcp add lotsofsounds --transport http https://api.lotsofsounds.com/mcp \
  --header "x-api-key: $LOS_API_KEY"

Cursor、ChatGPT、Claude Desktop、Windsurf 和其他 Streamable HTTP 客户端都可以连接到同一端点。客户端专属配置请参阅 MCP 设置指南。

完整 API

公开样例经过精心挑选，数量有限。经过身份验证的 API 还提供：

• 自然语言目录搜索
• 标签、类别、时长、排序和分页
• 完整音效元数据
• 限时流式和下载 URL
• 更高的生产环境使用限额

curl -G "https://api.lotsofsounds.com/api/v1/sounds" \
  -H "x-api-key: $LOS_API_KEY" \
  --data-urlencode "q=gentle notification chime" \
  --data-urlencode "max_duration=2"

阅读 API 文档、比较套餐，或注册并创建 API 密钥。

请将 API 密钥保存在服务器端。不要在浏览器包或公开仓库中暴露 LOS_API_KEY。

Lots of Sounds 与 Freesound API 对比

这两项服务都能帮助开发者查找音效，但本项目并非可直接替代 Freesound API 的实现。Lots of Sounds 提供规模较小、无需密钥的 CC0 样例集、面向 AI Agent 的官方托管 MCP 服务，以及用于生产环境搜索和下载的身份验证 API。请注意，端点、响应结构、目录覆盖范围和账号条款均有所不同。

常见问题

这是一个免费的音效 API 吗？

是的。样例列表和样例流端点无需账号或 API 密钥。完整目录搜索和下载需要使用 Lots of Sounds 付费套餐。

这些声音是 CC0 吗？

精选样本集采用 CC0 许可。发布音频前，请查看 Lots of Sounds 许可信息，了解完整目录和当前使用条款。

AI Agent 可以使用此 API 吗？

可以。REST API 会返回结构化 JSON，代码库包含一个 Agent 技能，托管的 MCP 服务则提供专用的声音工具。

此代码库包含音频文件吗？

不包含。此代码库包含文档、小型代码示例和一项 Agent 技能。音频由 Lots of Sounds API 提供。

许可证

代码库中的代码采用 MIT 许可证。API 返回的音频则受 Lots of Sounds 许可条款单独约束。