Hass/hass_stt_qwen

Fork 0

Files

T

zimonianhua 69f7a1e2cf

Validation And Formatting / HACS (push) Has been cancelled

Details

Validation And Formatting / Hassfest (push) Has been cancelled

Details

```

docs(README): 更新安装说明并添加HACS安装方法

- 修改手动安装路径说明，使表述更清晰
- 新增HACS安装方法作为推荐方式，包含详细步骤

chore(hacs): 统一组件名称表述
- 将HACS显示名称从"阿里语音识别"更新为"阿里通义千问语音识别"
- 保持与其他文档的一致性
```

2026-01-31 21:19:10 +08:00

3.0 KiB

Raw Permalink Blame History

Home Assistant 阿里云通义千问 STT 语音识别插件

本插件集成了阿里云通义千问 (Qwen) 实时语音识别服务，为 Home Assistant 提供高精度的语音转文字功能。

功能特性

模型支持：支持 qwen3-asr-flash-realtime（通义千问实时识别）。
图形化配置：支持通过 Home Assistant 前端界面直接添加集成。
多语言支持：支持中文、英文、粤语等多种语言识别。
实时识别：基于 WebSocket 协议，低延迟实时转写。
多区域支持：支持北京（国内）和新加坡（国际）节点。
音频格式：WAV（PCM 16-bit / 16kHz / 单声道）。

安装说明

方法一：手动安装

下载本项目代码。
将 /custom_components/下的hass_stt_qwen 文件夹复制到您的 Home Assistant 配置目录下的 custom_components 文件夹中。
- 最终路径应为：/config/custom_components/hass_stt_qwen/
重启 Home Assistant。

方法二：HACS 安装（推荐）

确保你已经在 Home Assistant 中安装并配置了 HACS（Home Assistant Community Store）。
点击 HACS 界面左上角的菜单，选择 自定义仓库（Custom repositories），在弹出的窗口中输入仓库地址 https://github.com/xyzmos/hass_stt_qwen，类别选择 集成，然后点击 添加。之后再搜索 阿里通义千问语音识别 即可找到。
选择 阿里通义千问语音识别 集成，点击 下载此存储库。
下载完成后，重启 Home Assistant。

配置指南

登录 Home Assistant。
点击左侧菜单的配置 -> 设备与服务。
点击右下角的 添加集成 按钮。
搜索 阿里通义千问语音识别 并点击。
在弹出的配置窗口中输入以下信息：
- API 密钥: 您的阿里云 DashScope API 密钥。
  - 获取方式：阿里云百炼控制台
- 模型: 选择您需要使用的模型（推荐 qwen3-asr-flash-realtime）。
- 区域: 根据您的 API Key 所在区域选择（北京或新加坡）。
点击提交完成配置。

使用方法

配置完成后，您可以在 Home Assistant 的语音助手设置中选择 阿里通义千问语音识别 作为语音转文字 (STT) 引擎。

进入配置 -> 语音助手。
选择或创建一个语音助手。
在 语音转文字 选项中选择 阿里通义千问语音识别。

常见问题

Q: 如何获取 API Key？ A: 请访问阿里云百炼控制台，开通服务并创建 API Key。

Q: 插件支持哪些 Home Assistant 版本？ A: 需要 Home Assistant 支持 SpeechToTextEntity（STT 实体）的版本。

Q: 支持哪些语言？ A: 通义千问 Qwen ASR 支持中文、英文、粤语、日语等多种语言。

Q: 遇到连接失败怎么办？ A: 请检查 API Key 是否正确，以及网络连接是否正常。如果您在海外，请尝试切换到新加坡区域。

3.0 KiB Raw Permalink Blame History Unescape Escape