开始使用 AngeVoice

这页只做一件事：让你从一台准备好的主机，走到可以成功下载并播放第一段语音。

Docker首次合成10–20 分钟

开始前确认

主机已安装 Docker 和 Docker Compose V2。
模型目录有足够空间；首次启动需要下载模型。
有 NVIDIA GPU 时已安装可被 Docker 使用的驱动；不确定时可以先选择 CPU。

选择部署方式

设备	建议方式	默认端口
没有 NVIDIA GPU，或先验证功能	`cpu`	`8100`
常规 NVIDIA x86_64 主机	`gpu`	`8101`
标准 GPU 镜像无法启动的旧驱动环境	`legacy-gpu`	`8102`

有 NVIDIA GPU 时先试标准 GPU。Legacy GPU 是兼容方案，不是更快的方案。

运行安装脚本

bash <(curl -fsSL https://raw.githubusercontent.com/AngeVox/AngeVoice/main/scripts/install.sh)

脚本会检查 Docker、网络和硬件，并引导你选择运行方式。访问 GitHub 较慢时，也可以先下载仓库：

git clone https://github.com/AngeVox/AngeVoice.git
cd AngeVoice
bash scripts/install.sh

打开安装脚本输出的 Studio 地址。
进入管理后台，首次可使用 admin / admin123。
立即修改管理员用户名和密码；不要把默认密码用于局域网以外的环境。
在安全页查看或轮换 API Key，并保存到客户端的安全配置中。

默认凭据只是首次进入路径。准备让其他设备访问前，必须先改密。

确认服务可用

把端口替换为你的部署端口：

curl http://127.0.0.1:8100/health
curl http://127.0.0.1:8100/v1/models

/health 返回 HTTP 200 且状态为 ok 或 idle，都表示服务可用。loading 表示模型仍在加载。

生成第一段语音

curl -X POST http://127.0.0.1:8100/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"model":"kokoro","input":"你好，这是 AngeVoice 的第一次合成。","voice":"zm_010","response_format":"wav"}' \
  --output hello.wav

播放 hello.wav。如果返回 401，请检查 Bearer Token；如果模型仍在下载，请等待 /health 结束 loading 状态。

下一步

需要选择模型：阅读选择 AngeVoice 模型。
需要接入阅读器或应用：阅读客户端接入。
准备开放给其他设备：先完成安全设置。