voysy查询api python库
voysis-python的Python项目详细描述
Voysis Python库
voysicpython库提供了一组允许python 与voysis查询api端点交互的应用程序。
还提供了一个命令行调用工具来提供 与voysicqueryapi交互的简单方法和一个工作示例 如何使用库类。
安装
要从pypi存储库安装,只需运行
pip3 install --upgrade voysis-python
或者要从此源代码树安装,请执行
python3 setup.py install
要求
voysicpython库和命令行工具需要python 3,其中 python 3.6是推荐的环境。
portaudio
需要在mac osx环境中操作。这个罐头
使用Homebrew
brew install portaudio
API文档
Voysis API的完整文档可以在以下位置找到: Voysis Developer Documentation
vtc:voysis测试客户端
这个项目提供了一个名为voysis-vtc
的命令行测试工具,它
提供了一种简单的方法来测试和交互一个吐音人工智能。
获得帮助
安装后,运行voysis-vtc --help
获取命令行摘要
参数和子命令可用。使用子命令重新运行工具
name和--help
将为该子命令提供进一步的帮助:
voysis-vtc query --help
指定语音ai端点
要对语音ai端点执行查询,您需要告诉 你语音的网址。此网址将由voysis提供给您。
若要提供给职业训练局,请使用global--url
选项:
voysis-vtc --url wss://test.voysis.io/websocketapi query
您还可以在环境中指定端点url,以便 不必每次调用都在命令行上提供:
export VTC_URL=wss://test.voysis.io/websocketapi
认证
您的语音ai端点将需要一个身份验证令牌
为查询成功指定。vtc命令支持
使用全局--auth-token
选项指定有效的刷新令牌:
voysis-vtc \
--auth-token=8U7CsQyiK8bqLwGnZUmnmgArbmiR9si50DIrjIHp5soAJ4i7NHB2Gg3IhlIgXYN1 \
--url=wss://test.voysis.io/websocketapi \
query
您还可以在您的环境中提供刷新令牌,这样您就不会 每次调用都需要在命令行上提供它:
export VTC_AUTH_TOKEN=8U7CsQyiK8bqLwGnZUmnmgArbmiR9si50DIrjIHp5soAJ4i7NHB2Gg3IhlIgXYN1
与您的语音交互ai
与你的语音人工智能交互的最直接的方式是发送一个 从麦克风录制的查询。
要录制语音查询并将其发送到语音ai,请执行
voysis-vtc query
并按照屏幕提示进行操作。
发送音频文件
vtc客户端可以发送包含音频数据的文件,而不是录制 从麦克风。当前仅包含原始样本或wav的文件 支持文件。如果发送原始样本,音频数据必须符合 以下参数:
- 16000Hz 16位有符号整数单通道PCM数据。
voysis-vtc query --send audio_data.wav
发送许多音频文件
vtc客户端支持按顺序将一批音频文件发送到 语音人工智能终端。包含许多wav文件的目录的路径 应在命令行中提供:
voysis-vtc query --batch /path/to/wav/folder
提供查询反馈
voysicqueryapi支持对
音频查询的结果。要提供此反馈,请使用feedback
子命令:
voysis-vtc feedback \
--query-id dda80ba2-f0fa-421d-8462-2f849bbb30b3 \
--rating 5 \
--description="Perfect results"
评级是1-5范围内的一个简单整数,1表示 质量最差,5个代表最好。描述是一种自由形式 字符串,可用于提供有关 查询结果不佳。此信息将存储在 并可用于语音分析,以改善语音ais。