环境要求与认证指南

使用 NavTalk 实时数字人或合成数字人前，请确保您的运行环境和认证信息已准备完毕。

系统与依赖环境

项目	要求说明
操作系统	Windows Server 2019 或更高版本，或主流 Linux（如 Ubuntu 20.04+）
Python	3.10 及以上
CUDA	11.7（仅在使用 GPU 加速时需要）
GPU 推荐	NVIDIA RTX 4090 或等效高性能 GPU
运行环境建议	使用虚拟环境（如 venv）隔离依赖，确保项目稳定

---

🔐 认证与密钥配置

所有接口调用前，您需要完成身份认证并传入 License 参数（即 API Key）以完成权限验证。

获取方式：

1. 前往 NavTalk 控制台

2. 注册账户并登录

3. 在「密钥管理」页面中生成您的 API Key（license）

接入示例：

// 创建 WebSocket 时传入 license 参数
const websocketUrlWithParams = `${websocketUrl}?license=${encodeURIComponent(license)}&char=yourCharacterId`;

出于安全考虑，请避免直接将 license 写入前端代码中或暴露在网页请求中。License 相当于您的访问令牌，一旦被他人获取，即可冒用身份调用接口，造成计费损失或敏感信息泄露。

推荐的保护策略：

场景	推荐方式
Web 应用前端调用	❌ 不推荐直接在前端暴露 License
后端接入控制	✅ 建议在后端维护 License，并通过登录态分发受限调用权限
临时授权机制	✅ 可以为用户生成临时 Token，后端映射真实 License，再进行转发
多租户环境	✅ 针对不同业务线或客户，使用不同的 License 进行隔离授权

若您怀疑密钥泄露，请立即前往控制台点击「重置密钥」。重置后，旧 License 立即失效，请及时替换调用端配置