Skip to content

Python

获取 SDK

提示

Windows 用户需要安装 VC++ 运行时环境。

点击下载

访问 https://github.com/acrcloud/acrcloud_sdk_python 根据需求选择合适的版本

使用 cd 命令进入到 SDK 所在文件夹后运行安装命令

bash
$ python setup.py install

初始化

首先进入 ACRCloud 开发者平台 控制台 > 音频/视频识别 来获取 Access Key, Access Secret 以及 Host。 然后将获取到的配置信息导入 ACRCloudRecognizer 并初始化。

python
from acrcloud.recognizer import ACRCloudRecognizer

config = {
    'host': '获取到的 Host',
    'access_key': '获取到的 Access Key',
    'access_secret': '获取到的 Access Secret',
    'timeout': 10  # seconds
}

client = ACRCloudRecognizer(config)

方法

recognize_by_file(file_path, start_seconds, rec_length)

识别多媒体文件指定位置

参数描述
file_path多媒体文件路径
start_seconds识别开始位置(单位:秒)
rec_length识别长度(单位:秒,默认为 10,最大不超过 12)

示例代码

python
# 识别 test.mp4 文件的 0 到 10 秒的内容
result = client.recognize_by_file('test.mp4', 0, 10)

recognize_by_filebuffer(file_buffer, start_seconds, rec_length)

识别已经读取的多媒体文件指定位置

参数描述
file_buffer读取的多媒体文件的 buffer
start_seconds识别开始位置(单位:秒)
rec_length识别长度(单位:秒,默认为 10,最大不超过 12)

示例代码

python
# 识别 test.mp4 文件的 0 到 10 秒的内容
with open('test.mp4', 'rb') as f: 
    file_buffer = f.read()
result = client.recognize_by_filebuffer(file_buffer, 0, 10)

recognize_by_fpbuffer(fp_buffer, start_seconds, rec_length)

识别已经读取的指纹文件指定位置

参数描述
fp_buffer读取的指纹的 buffer
start_seconds识别开始位置(单位:秒)
rec_length识别长度(单位:秒,默认为 10,最大不超过 12)

示例代码

python
# 识别指纹文件 test.db.lo 的 0 到 10 秒的内容
with open('test.db.lo', 'rb') as f:
    fp_buffer = f.read()
result = client.recognize_by_fpbuffer(fp_buffer, 0, 10)

get_duration_ms_by_file(file_path)

获取多媒体文件的总时长

参数描述
file_path多媒体文件路径

示例代码

python
# 获取多媒体文件的总时长
duration_ms = client.get_duration_ms_by_file('test.mp4')

get_duration_ms_by_fpbuffer(fp_buffer)

获取指纹文件的总时长

参数描述
fp_buffer读取的指纹文件的buffer

示例代码:

python
# 获取已经读取的指纹文件的总时长
with open('test.db.lo', 'rb') as f:
    fp_buffer = f.read()
duration_ms = client.get_duration_ms_by_fpbuffer(fp_buffer)

SDK 合规详情:

SDK名称:ACRCloud 音频识别 SDK

开发者:高第网络技术(北京)有限公司

SDK 合规说明与指引: 链接

SDK 隐私政策: 链接