openai-edge-tts

环境要求

• Docker（使用 Docker / Docker Compose 方式时必须）
• Python 与 pip（使用 Python 本地运行方式时必须）
• 可访问微软 Edge 在线 TTS 服务的网络（edge-tts 依赖在线服务）

安装与启动步骤

1. 1直接启动容器

   最快的方式，使用默认配置在 5050 端口启动服务，无需克隆代码。

   docker run -d -p 5050:5050 travisvn/openai-edge-tts:latest

   复制

2. 2克隆项目代码

   需要自定义配置或本地构建时，先拉取仓库并进入目录。

   git clone https://github.com/travisvn/openai-edge-tts.git
   cd openai-edge-tts

   复制

3. 3生成配置文件

   复制默认配置为 .env，再按需修改 API_KEY、PORT、默认声音等。

   cp .env.example .env

   复制

4. 4Compose 启动服务

   推荐的本地运行方式，加 -d 可后台运行，不占用终端。

   docker compose up -d

   复制

5. 5本地构建镜像

   不用 Compose 时，先构建镜像再用 --env-file 加载 .env 启动。

   docker build -t openai-edge-tts .
   docker run -d -p 5050:5050 --env-file .env openai-edge-tts

   复制

6. 6启用 ffmpeg 支持

   默认镜像不含 ffmpeg，非 MP3 格式转换需开启该构建参数。

   INSTALL_FFMPEG_ARG=true docker compose up --build

   复制

7. 7Python 方式运行

   建议先建虚拟环境，安装依赖后启动服务，同样监听 5050 端口。

   pip install -r requirements.txt
   python app/server.py

   复制

关键配置

如何确认成功

访问 http://localhost:5050 能连通，且 POST /v1/audio/speech 能返回音频即成功。

常见问题

注意事项

• Windows 与 Linux 均可运行，Docker 方式需要能拉取镜像。
• 不装 ffmpeg 时仅建议使用 MP3 输出格式。
• SSE 流式示例中需把 Authorization 换成你自己的 API_KEY。
• edge-tts 依赖微软在线服务，离线环境不可用。