语音服务提供 Swagger 规范，用于与少量 REST API 交互，用于导入数据、创建模型、测试模型准确性、创建自定义终结点、排队批量听录和管理订阅。 可以使用这些 API 以编程方式完成通过 语音工作室的自定义语音区域 提供的大多数操作。
注释
语音服务具有多个 REST API，用于 语音转文本 和 文本转语音。
但是，Swagger 规范中仅记录 语音转文本 REST API 。 有关所有其他语音服务 REST API 的信息，请参阅上一段中引用的文档。
从 Swagger 规范生成代码
Swagger 规范提供了选项，可用于快速测试各种路径。 但是，有时需要为所有路径生成代码，从而创建一个可以基于未来解决方案的调用库。 让我们看看为语音转文本 REST API 版本 3.1 生成 Python 库的过程。
需要将 Swagger 设置为语音资源的区域。 可以在 Azure 门户中语音资源设置的 “概述 ”部分中确认区域。 此处提供了支持区域的完整列表。
- 在浏览器中，转到 https://editor.swagger.io
- 选择 “文件”，选择“ 导入 URL”
- 输入 URL
https://github.com/Azure/azure-rest-api-specs/blob/master/specification/cognitiveservices/data-plane/Speech/SpeechToText/stable/v3.1/speechtotext.json，然后选择“ 确定”。 - 选择“ 生成客户端 ”，然后选择 “python”。 客户端库将作为
.zip文件下载到您的计算机。 - 从下载中提取所有内容。 您可以使用
tar -xf提取所有内容。 - 将提取的模块安装到 Python 环境中：
pip install path/to/package/python-client - 已安装的包命名
swagger_client。 检查安装是否成功：
python -c "import swagger_client"
可以使用 GitHub 上的语音服务示例生成的 Python 库。