通过 freesound api 下载音频数据

在 freesound.org 官网上请求 APIv2 凭证（https://freesound.org/apiv2/apply）。需要注意，APIv2 的使用仅限于一定的使用率。标准使用费率设置为每分钟 60 个请求和每天 2000 个请求。包括上传、描述、评论、评分和书签声音在内的资源具有更严格的速率，即每分钟 30 个请求和每天 500 个请求。

安装相关的 python 包：

1
pip install freesound-python
2
pip install requests-oauthlib

获取音频元信息#

搜索#

1
import freesound
2

3
client = freesound.FreesoundClient()
4
client.set_token("<your_api_key>","token")
5

6
results = client.text_search(
7
  query="violoncello",
8
    filter="tag:tenuto duration:[1.0 TO 15.0]",
9
    sort="rating_desc",
10
    fields="id,name,previews,username",
11
)
12

13
for sound in results:
14
    print(sound.name)

query 为查询，fields 为需要获取的元信息，filter 为过滤器，sort 为排序方式。text_search 返回的是一个 Pager 对象，结构如下：

1
{
2
  "count": <total number of results>,
3
  "next": <link to the next page of results (null if none)>,
4
  "results": [
5
      <sound result #1 info>,
6
      <sound result #2 info>,
7
      ...
8
      <sound result #page_size info>
9
  ],
10
  "previous": <link to the previous page of results (null if none)>
11
}

可以通过设置 text_search 的 page 和 page_size 参数设置需要返回哪一页以及每页有多少结果。

获取随机音频#

通过 https://freesound.org/browse/random/ 可以获取随机的音频 id，接着通过 api 搜索即可获取音频

1
import freesound
2
import request
3
import re
4

5
response = requests.get("https://freesound.org/browse/random/")
6
sound_id = re.search(r'/sounds/(\d+)/', reponse.text).group(1)
7
sound = client.get_sound(sound_id)
8
print(sound.name)

下载音频#

下载预览音频的代码如下：

1
# sound 为 client 获取到的音频，例如 sound = client.get_sound(<sound_id>)
2
sound.retrieve_preivew(file_path, name=f"{sound['id']}.mp3", quality="hq", file_format="mp3")

quality 为预览音频的质量，有 "lq" 和 "hq" 两个选项，分别代表低质量和高质量。默认下载的是低质量音频。低质量音频的下载速度会比高质量音频快很多。音频文件格式可以选择 mp3 和 ogg 两种。

下载原始音频需要 OAuth2 认证，OAuth2 认证需要以下步骤：

1
from requests_oauthlib import OAuth2Session
2

3
import freesound
4

5
client_id = "<your_client_id>"
6
client_secret = "<your_client_secret>"
7

8
# do the OAuth dance
9
oauth = OAuth2Session(client_id)
10

11
authorization_url, state = oauth.authorization_url(
12
    "https://freesound.org/apiv2/oauth2/authorize/"
13
)
14
print(f"Please go to {authorization_url} and authorize access.")
15

16
authorization_code = input("Please enter the authorization code:")
17
oauth_token = oauth.fetch_token(
18
    "https://freesound.org/apiv2/oauth2/access_token/",
19
    authorization_code,
20
    client_secret=client_secret,
21
)
22

23
client = freesound.FreesoundClient()
24
client.set_token(oauth_token["access_token"], "oauth")