模型

本模块说明如何让 OpenTalking 的完整模型链路跑起来，而不仅是 talking-head backend。 一个可用的数字人会话依赖五类能力：

flowchart LR
    STT[语音识别<br/>可选语音输入]
    LLM[LLM<br/>决定说什么]
    TTS[TTS<br/>文本转语音]
    Avatar[Avatar 资产<br/>图片 / 帧 / 模板视频]
    Head[Talking-head backend<br/>音频转视频]
    WebRTC[WebRTC<br/>浏览器推流]

    STT --> LLM --> TTS --> Head --> WebRTC
    Avatar --> Head

推荐默认值

层级	首次运行默认值	何时替换
LLM	DashScope OpenAI-compatible endpoint	已有 OpenAI、vLLM、Ollama、DeepSeek 等标准服务时替换。
STT	DashScope Paraformer realtime	需要接入其它实时 STT provider 时替换。
TTS	Edge TTS	生产音色、声音复刻或更高质量语音时切换 DashScope、CosyVoice、ElevenLabs。
Avatar 资产	内置 examples	选择 Wav2Lip、QuickTalk、FlashHead、FlashTalk 前准备模型匹配资产。
Talking-head backend	先用 mock，再跑 Wav2Lip local 路径	需要 QuickTalk local/OmniRT、FlashTalk OmniRT、FlashHead direct WS 或其它模型服务时替换。

推荐顺序

1. 用 快速上手 跑通 mock。
2. 先看 支持矩阵，选对部署路径。
3. 配置 LLM 与 STT。
4. 选择并验证 TTS。
5. 准备 Avatar 资产。
6. 启动 Talking-head 模型。
7. 验证 /models，创建会话，并通过浏览器测试。

模型快捷入口

目标	入口
无权重端到端自测	Mock
第一个真实唇形模型	Wav2Lip Local
本地 STT/TTS + QuickTalk	本地 STT/TTS + QuickTalk
V100 单机部署 FasterLivePortrait + FlashHead	V100 + FasterLivePortrait + FlashHead
已有 MuseTalk runtime	MuseTalk with OmniRT
本地实时 adapter	QuickTalk Local
单卡实时头像贴回链路	FasterLivePortrait
高质量重模型	FlashTalk
独立 FlashHead 服务	FlashHead

模型执行应与 OpenTalking 编排层解耦：轻量模型优先使用 local 或 direct_ws，OmniRT 保留为重模型、多卡、远端或 NPU 部署的推荐 backend。

前端入口

模型或后端服务启动后，统一用 OpenTalking WebUI 访问：

终端

cd "$OPENTALKING_HOME"
bash scripts/quickstart/start_frontend.sh --api-port 8000 --web-port 5173 --host 0.0.0.0

远程服务器部署时，把本地浏览器端口映射到服务器 5173，再打开 http://127.0.0.1:5173。