SuperAPI AI 工具集

azure-speech-to-text-rest-py

编程与开发

查看项目

更新于 10-16 06:22

技能介绍

用途:通过 Azure 语音转文本 REST 接口,对不超过 60 秒的短音频文件做语音识别,适合不想引入 Speech SDK 的简单转写场景。

主要能力:支持 WAV PCM 16kHz 单声道(推荐)与 OGG OPUS 格式;返回 simple 或 detailed 结果,detailed 含置信度与 NBest;支持 profanity 参数(masked/removed/raw);支持订阅密钥或 Bearer Token 两种鉴权;可用分块传输降低延迟;提供同步、异步(aiohttp)与错误处理示例。

使用方式:需先准备 Azure 订阅与语音资源,配置环境变量 AZURE_SPEECH_KEY、AZURE_SPEECH_REGION(或 AZURE_SPEECH_ENDPOINT)。安装依赖:pip install requests。请求地址为 https://{region}.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1,请求头使用 Ocp-Apim-Subscription-Key,Content-Type 按格式设置,查询参数含 language、format、profanity。

适用场景:短语音命令、单句转写、需要置信度评分的简单识别。

限制:音频最长 60 秒,发音评估最长 30 秒;无部分/中间结果,仅返回最终结果;不支持实时流式转写、语音翻译、自定义语音模型与批量转写,这些场景应改用 Speech SDK 或 Batch Transcription API。语言代码需正确指定,如 en-US、zh-CN 等。

其他:Token 有效期 10 分钟,建议缓存约 9 分钟;生产代码需处理 Success、NoMatch、InitialSilenceTimeout、BabbleTimeout、Error 等 RecognitionStatus。具体收费与价格资料暂未提供。