首页
搜索 K

Appearance

🌊 Kokoro API 部署指南 ​

📖 简介 ​

Kokoro 是一个轻量级、高性能的语音合成模型，专为 CPU 环境优化，在无 GPU 的情况下也能快速运行。

🔗 官方仓库：https://www.modelscope.cn/models/AI-ModelScope/Kokoro-82M-v1.1-zh/summary

✨ 特点 ​

特性描述
⚡ 极速推理CPU 环境下表现优秀
🎭 多音色预训练 100+ 种中文音色
💾 轻量化模型仅 82M 参数
🚀 快速部署简单配置即可运行
🎯 专注中文针对中文语音优化

⚡ 性能参考 ​

🖥️ CPU 性能测试

在 12700 CPU 上测试（无 GPU 加速）：

  • 💾 内存占用：2~3 GB
  • ⏱️ 转换 145 个汉字：约 13~15 秒
  • 🎯 CPU 友好型模型

⚠️ 注意事项

  • 🎵 效果不如 CosyVoice 那么自然
  • 🗣️ 不支持声音克隆（只能使用预训练音色）
  • 🎨 音色选择有限（但已有 100+ 种可选）
  • 🧪 如需自定义音色，需要自行训练模型

🎯 项目目标 ​

快速部署一个 Kokoro API 服务，提供预设音色语音合成功能。

🐳 Docker API 服务部署 ​

📥 第一步：克隆代码 ​

bash
git clone https://gitee.com/ZengYu1998/kokoro-docker-api.git
cd kokoro-docker-api

🔨 第二步：构建 Docker 镜像 ​

bash
docker build -t kokoro-docker-api .

🚀 第三步：运行容器 ​

💡 建议

建议将输出目录映射到宿主机，方便获取生成的音频文件。

基础运行命令：

bash
# 使用 CPU 运行（推荐，专为 CPU 优化）
docker run -itd --restart always \
  --name kokoro-docker-api \
  -p 8001:8001 \
  -v /你的路径:/app/out \
  kokoro-docker-api
bash
# 使用 GPU 运行（可选，性能提升有限）
docker run -itd --restart always \
  --gpus all \
  --name kokoro-docker-api \
  -p 8001:8001 \
  -v /你的路径:/app/out \
  kokoro-docker-api

Windows 示例：

bash
# 生产环境运行
docker run -itd --restart always \
  -p 8001:8001 \
  -v E:\Project\Python\kokoro-docker-api\out:/app/out \
  kokoro-docker-api
bash
# 测试环境（进入容器交互模式）
docker run -it --rm \
  -p 8001:8001 \
  -v E:\Project\Python\kokoro-docker-api\out:/app/out \
  kokoro-docker-api bash

🎭 音色选择 ​

Kokoro 预训练了 100+ 种中文音色，包括：

类别数量示例
👨‍💼 男声40+沉稳、阳光、磁性、温柔
👩‍💼 女声40+甜美、知性、活泼、优雅

✅ 验证服务 ​

服务启动后，访问以下地址查看 API 文档：

http://localhost:8001/docs