Skip to content

HACS 自定义集成,用于在 Assist 管道中使用 OpenAI 云语音转文本 (Whisper) API,从而减少 Home Assistant 服务器的工作负载。

License

Notifications You must be signed in to change notification settings

knoop7/groqcloud_whisper

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Whisper STT Cloud API 集成到 Home Assistant 🏠🎙️

要求 📖

  • GroqCloud 账户 👤 --> 你可以在这里创建一个
  • API 密钥 🔑 --> 你可以在这里生成一个

模型

GroqCloud 的所有 Whisper 模型每天免费使用最多 28800 秒音频!

  • whisper-large-v3
  • distil-whisper-large-v3-en - 优化版本的 whisper-large-v3

如何安装 ⚙️

在配置集成之前,必须先安装 custom_integration。你可以通过 HACS 或手动方式进行安装。

HACS ✨

  1. 复制 这个 URL 并粘贴到你的 HACS 自定义仓库中:

    https://github.com/knoop7/groqcloud_whisper
  2. 安装 💻 OpenAI Whisper Cloud 集成

  3. 重启 🔁 Home Assistant

手动安装 ⌨️

  1. 下载 这个仓库
  2. 复制 custom_components 文件夹中的所有内容到你的 Home Assistant 的 custom_components 文件夹中。
  3. 重启 Home Assistant

配置 🔧

你可以配置以下参数:

  • api_key: (必填) API 密钥
  • proxy: (必填) 代理地址,需要搭配容器镜像
  • temperature: (可选) 采样温度,范围在 0 到 1 之间。默认值 0.4
  • prompt: (可选) 用于提高语音识别的准确性,特别是词汇或名称。默认值 ""
    提供一个由逗号 , 分隔的词汇或名称列表
    示例: "open, close, Chat GPT-3, DALL·E"

现在你可以通过 Home Assistant 仪表盘进行设置(不支持 YAML 配置)。

镜像容器使用方法 🚀

拉取镜像

docker pull ghcr.io/knoop7/ha-openai-whisper-stt-api/groq-proxy2:20240830

运行镜像容器

docker run -d -p 8020:8020 \
  -e HOST="0.0.0.0" \
  -e PORT="8020" \
  -e PROXY_URL="" \ 
  -e AUDIO_URL="https://api.groq.com/openai/v1/audio/transcriptions" \
  -e TIMEOUT="60" \
  ghcr.io/knoop7/ha-openai-whisper-stt-api/groq-proxy2:20240830

参数解释

  • docker run -d: 以后台模式运行容器. 🖥️
  • -p 8020:8020: 将主机的 8020 端口映射到容器的 8020 端口. 🔄
  • -e HOST="0.0.0.0": 设置容器内的环境变量 HOST0.0.0.0,使容器监听所有网络接口. 🌐
  • -e PORT="8020": 设置容器内的环境变量 PORT8020。🔢
  • -e PROXY_URL="": 设置容器内的环境变量 PROXY_URL"",用于设置代理地址,这里为空. 🕵️‍♂️
  • -e AUDIO_URL="https://api.groq.com/openai/v1/audio/transcriptions": 设置容器内的环境变量 AUDIO_URLhttps://api.groq.com/openai/v1/audio/transcriptions,指定音频转文字的 API 地址. 🎤
  • -e TIMEOUT="60": 设置容器内的环境变量 TIMEOUT60,表示超时时间为 60 秒. ⏳

About

HACS 自定义集成,用于在 Assist 管道中使用 OpenAI 云语音转文本 (Whisper) API,从而减少 Home Assistant 服务器的工作负载。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%