freesound音频查找服务
专用API
服务商:
freesound
【更新时间: 2024.07.08】
使用 Freesound API,您可以浏览、搜索和检索信息,包括用户、包和声音本身。你可以找到与给定目标相似的声音(基于内容分析) 并从音频文件中检索自动提取的特征,以及执行结合内容分析功能和其他元数据(标签等)...
|
- API详情
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
什么是freesound音频查找服务?
使用Freesound API,您可以浏览、搜索和检索有关 Freesound 用户、包和声音本身的信息。您可以找到与给定目标相似的声音(基于内容分析)并从音频文件中检索自动提取的特征,以及执行结合内容分析特征和其他元数据(标签等)的高级查询。使用 Freesound API,您还可以上传、评论、评分和收藏声音!
什么是freesound音频查找服务?
freesound音频查找服务有哪些核心功能?
- 搜索声音:有几种方法可以使用 Freesound APIv2 搜索声音。最基本的方法是使用文本搜索资源,它允许您定义一些查询词和其他参数来过滤查询结果。
- 下载声音:Freesound APIv2 允许您从 Freesound 下载声音。有两种方法可以下载声音。第一种方法是下载已上传到 Freesound 的特定声音的原始文件。您可以使用下载声音(需要 OAuth2)资源执行此操作。此资源允许您以最高质量检索文件,但格式取决于上传声音的原始格式(可以是 .wav、.aif、.flac、.ogg 或 .mp3)。这意味着声音的重量会根据格式而有很大差异。
- 上传声音:APIv2 还允许您将声音上传到 Freesound!通过提供音频文件和一些元数据(我们称之为声音描述)来上传声音。最低限度的声音描述包括标签列表、声音的文本描述以及应发布声音的许可证。您可以使用上传声音(需要 OAuth2)资源(需要 OAuth2)上传和描述声音。或者,您可以简单地使用上传声音(需要 OAuth2)资源上传音频文件,然后使用描述声音(需要 OAuth2)资源对其进行描述。
- 更多:除了搜索和上传/下载声音之外,APIv2 还允许您检索有关声音分析、类似声音、声音包、用户、书签的信息……
freesound音频查找服务的核心优势是什么?
1. 快速索引和浏览:音频搜索引擎能够快速索引音频和视频文件,帮助用户快速找到所需的内容。
2. 基于声音的搜索:与传统的文本搜索不同,音频搜索基于声音识别,即使在拼写错误的情况下也能提供相关结果。
3. 高准确率:音频搜索服务如Deepgram提供的平均80%的准确率,相比传统语音转文本搜索方式的20%准确率有显著提升。
4. 响应速度快:一旦音频文件被索引,搜索服务可以在几秒钟内找到搜索字词,并跳转到音频中提及关键字的时间点。
在哪些场景会用到freesound音频查找服务?
1.音频搜索和检索:
-
- 音效制作:用户可以浏览和搜索来自全球社区上传的各种音频片段,用于电影、游戏或多媒体项目中的音效制作。
- 声音识别:通过内容分析,找到与特定目标(如环境声音、乐器演奏等)相似的声音样本,用于音频识别和匹配。
2.社区互动和数据贡献:
-
- 用户上传和分享:用户可以通过API上传自己的音频内容,扩展Freesound社区的声音库。
- 评论和评级:API支持用户对声音文件进行评论和评级,促进社区互动和反馈。
3.特征提取和分析:
-
- 音频特征提取:API允许用户从音频文件中提取自动特征,如频谱、音高、节奏等,用于音频分析和分类。
- 内容分析:结合自动提取的特征和元数据(如标签),进行高级查询和分析,以理解音频内容和其用途。
4.教育和研究:
-
- 音频教育资源:教育机构和研究人员可以利用API访问丰富的音频资源,用于教学、学术研究或实验目的。
- 音频数据分析:研究人员可以利用API进行大规模的音频数据分析,探索声音模式、趋势和文化影响等。
认证
APIv2 提供两种身份验证策略:基于令牌的身份验证和 OAuth2。
基于令牌的身份验证是最简单的身份验证,因为它只需要开发人员请求 API 凭据 (https://freesound.org/apiv2/apply) 并将提供的 API 密钥添加到所有请求(见下文)。 OAuth2 身份验证的流程稍微复杂一些,但它允许用户登录 Freesound 从您的应用程序。这将启用非“只读”资源,例如上传或分级声音。OAuth2 资源要求通过 https 发出请求。 大多数资源都可以使用两种身份验证策略进行访问,但其中一些资源是可访问的 仅限于使用 OAuth2。这些资源在“资源”页面中标记为“需要 OAuth2”。
令牌身份验证
要使用令牌策略验证 API 调用,您需要创建一个 Freesound 帐户(如果您还没有! 并通过访问 https://freesound.org/apiv2/apply 请求新的 API 凭据。 在此页面中,您将看到一个表,其中包含您请求的所有 API 凭据以及一些其他信息。你应该使用 “客户端密钥/Api 密钥”列中的键,这些键是长字母数字字符串。 您应该为您开发的每个应用程序获取不同的 API 密钥。
获得 API 密钥后,您需要将其添加到您向 API 发出的每个请求中。您可以通过以下方式做到这一点 将密钥添加为 GET 参数...token
curl "https://freesound.org/apiv2/search/text/?query=piano&token=YOUR_API_KEY"
…或者将其添加为授权标头:
curl -H "Authorization: Token YOUR_API_KEY" "https://freesound.org/apiv2/search/text/?query=piano"
这就是我们需要了解的有关令牌身份验证的全部信息!
OAuth2 身份验证¶
要使用 OAuth2 验证 API 调用,您还需要创建一个 Freesound 帐户(如果您还没有! 并通过访问 https://freesound.org/apiv2/apply 请求新的 API 凭据。我们的 OAuth2 实现 遵循RFC6749 (http://tools.ietf.org/html/rfc6749) 中描述的“授权代码授予”流程。那股流 基本上由三个步骤组成:
- 第 1 步:您的应用程序将用户重定向到 Freesound 页面,他们在此登录并要求他们授予您的应用程序权限。
- 第 2 步:如果用户授予对您的应用程序的访问权限,Freesound 会将用户重定向到您提供的 URL,并将授权授予作为 GET 参数*。
- 第 3 步:您的应用程序使用该授权权限请求访问令牌,该令牌将最终用户与您的应用程序“链接”,然后您需要将其添加到所有 API 请求中。
*如果您的应用程序无法处理请求,还可以将用户重定向到另一个 Freesound 页面,该页面打印 屏幕上的授权授予,以便用户可以在您的应用程序中手动引入它。
所有这些步骤和所有其他进一步的 OAuth2 API 请求都需要通过 https 发出。
认证
APIv2 提供两种身份验证策略:基于令牌的身份验证和 OAuth2。
基于令牌的身份验证是最简单的身份验证,因为它只需要开发人员请求 API 凭据 (https://freesound.org/apiv2/apply) 并将提供的 API 密钥添加到所有请求(见下文)。 OAuth2 身份验证的流程稍微复杂一些,但它允许用户登录 Freesound 从您的应用程序。这将启用非“只读”资源,例如上传或分级声音。OAuth2 资源要求通过 https 发出请求。 大多数资源都可以使用两种身份验证策略进行访问,但其中一些资源是可访问的 仅限于使用 OAuth2。这些资源在“资源”页面中标记为“需要 OAuth2”。
令牌身份验证
要使用令牌策略验证 API 调用,您需要创建一个 Freesound 帐户(如果您还没有! 并通过访问 https://freesound.org/apiv2/apply 请求新的 API 凭据。 在此页面中,您将看到一个表,其中包含您请求的所有 API 凭据以及一些其他信息。你应该使用 “客户端密钥/Api 密钥”列中的键,这些键是长字母数字字符串。 您应该为您开发的每个应用程序获取不同的 API 密钥。
获得 API 密钥后,您需要将其添加到您向 API 发出的每个请求中。您可以通过以下方式做到这一点 将密钥添加为 GET 参数...token
curl "https://freesound.org/apiv2/search/text/?query=piano&token=YOUR_API_KEY"
…或者将其添加为授权标头:
curl -H "Authorization: Token YOUR_API_KEY" "https://freesound.org/apiv2/search/text/?query=piano"
这就是我们需要了解的有关令牌身份验证的全部信息!
OAuth2 身份验证¶
要使用 OAuth2 验证 API 调用,您还需要创建一个 Freesound 帐户(如果您还没有! 并通过访问 https://freesound.org/apiv2/apply 请求新的 API 凭据。我们的 OAuth2 实现 遵循RFC6749 (http://tools.ietf.org/html/rfc6749) 中描述的“授权代码授予”流程。那股流 基本上由三个步骤组成:
- 第 1 步:您的应用程序将用户重定向到 Freesound 页面,他们在此登录并要求他们授予您的应用程序权限。
- 第 2 步:如果用户授予对您的应用程序的访问权限,Freesound 会将用户重定向到您提供的 URL,并将授权授予作为 GET 参数*。
- 第 3 步:您的应用程序使用该授权权限请求访问令牌,该令牌将最终用户与您的应用程序“链接”,然后您需要将其添加到所有 API 请求中。
*如果您的应用程序无法处理请求,还可以将用户重定向到另一个 Freesound 页面,该页面打印 屏幕上的授权授予,以便用户可以在您的应用程序中手动引入它。
所有这些步骤和所有其他进一步的 OAuth2 API 请求都需要通过 https 发出。