FlashHead

支持状态

项	值
模型 ID	flashhead
Backend	direct_ws
证据等级	已文档化
推荐用途	已有独立 FlashHead WebSocket 服务

推荐硬件

由 FlashHead 服务自行决定。OpenTalking 只连接其 HTTP/WebSocket 端点。

权重下载

OpenTalking 不管理 FlashHead 权重。常用搜索入口：

• Hugging Face 搜索 SoulX FlashHead
• ModelScope 搜索 FlashHead
• 魔乐社区搜索 FlashHead

目录结构

权重目录由 FlashHead 服务管理。OpenTalking 只需要 avatar manifest 与服务 URL。

配置项

.env

OPENTALKING_FLASHHEAD_WS_URL=ws://<flashhead-host>:8766/v1/avatar/realtime
OPENTALKING_FLASHHEAD_BASE_URL=http://<flashhead-host>:8766
OPENTALKING_FLASHHEAD_MODEL=soulx-flashhead-1.3b

configs/default.yaml

models:
  flashhead:
    backend: direct_ws

启动命令

先启动 FlashHead 服务，再启动 OpenTalking：

终端

bash scripts/quickstart/start_all.sh

/models 验证

终端

curl -s http://127.0.0.1:8000/models | python3 -m json.tool

配置 WebSocket URL 后，期望：

{"id":"flashhead","backend":"direct_ws","connected":true,"reason":"direct_ws"}

常见错误

现象	处理
reason=not_configured	设置 OPENTALKING_FLASHHEAD_WS_URL。
WebSocket 握手失败	检查 FlashHead 服务路径、端口和跨机器网络。
Avatar 不匹配	使用 model_type: flashhead 的 avatar。

前端入口

模型或后端服务启动后，统一用 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。