资源汇总（后端 ruoyi-aihuman-backend）

汇总后端项目 ruoyi-aihuman-backend 运行所依赖的第三方平台、模型与基础设施凭证。

部署 / 换环境时，下列密钥与地址需按新环境替换。

维护提示：本文只记录配置位置，实际密钥值以 ruoyi-admin/src/main/resources/application.yml 的 aihuman.* 段为准，不复制真实密钥。

参考：bigscreen/数字人文档/数字人资源整理.md（第二节「第三方平台与凭证清单」）。

---

一、第三方平台与凭证清单（换环境需替换）

平台	后端用途（模块 / 能力）	需要的凭证	配置位置	费用
阿里云智能语音交互 （NLS）	TTS 非流式整段合成（/tts/aliyun） 即将弃用（第一版遗留，后续移除该模式）	Appkey、AccessKey ID AccessKey Secret	aihuman.tts.aliyun.appkey access-key-id access-key-secret	年费 3万次/100元/年
阿里云百炼 （DashScope）	TTS 实时语音合成（流式双工 /tts/aliyunStream/ws） TTS 预设语音 mp3 生成（/tts/qwen/download） 3.1 统一采用	API Key（sk- 开头） 业务空间 WebSocket 域名（url）	aihuman.tts.aliyun.realtime.api-key url	按量付费，价格更低 输入：1.5元/百万tokens 输出：12元/百万tokens
硅基流动 （SiliconFlow）	ASR 语音转文本 + NLU 语义识别 两份可共用同一 Key	API Key	aihuman.asr.siliconflow.api-key aihuman.nlu.siliconflow.api-key	免费
智谱 GLM	NLU 语义识别（当前默认 provider）	API Key	aihuman.nlu.zhipu.api-key	免费
TTS 接口安全 （⚠️ 仅有代码骨架，当前未生效）	设计意图： 前端以 X-TTS-Token 头携带令牌， 保护 TTS 接口	访问令牌	aihuman.tts.security.access-token	免费

TTS 接口安全当前并未真正生效（仅有代码骨架）

后端已实现 TtsSecurityInterceptor（IP 白名单 + access-token 校验）与 TtsSecurityConfig（aihuman.tts.security），但 实际在用的接口全部被绕过、前端也未携带令牌，因此当前无法起到防护作用：

• TtsWebMvcConfig 将实际在用的路径 /digital-human/tts/aliyun、/aliyun/download、/qwen/download、/aliyunStream/** 全部加入 excludePathPatterns，跳过校验（注释自述为「临时便于联调，后续应移除」）；
• 前端（*.js/ts/vue/html）没有任何一处携带 X-TTS-Token；
• application.yml 中 access-token 仍是占位串 tts-...-CHANGE-ME，allowed-ips 为空（不校验 IP）。

且该方案本身就是「固定 Access Token」而非共享登录态——TtsSecurityConfig 注释明确：「本项目是独立服务（不依赖主后端用户登录态），采用固定 Access Token + 可选 IP 白名单」。固定令牌一旦被截获即可被劫持复用。

若目标是「数字人后台与业务后台共享 token 校验」，需另做改造：由业务后台签发、数字人后台校验同一套 Authorization/JWT，而非当前这套已留桩的固定 token。

---

二、基础设施

资源	用途	说明
Redis	对话历史、工具调用挂起结果（暂未使用）+ 大屏-手机配对状态	必需；后端不依赖 MySQL，全部状态在 Redis
线程池	异步对话 / SSE 推送（暂未使用，内置 LLM 对话前端未调用）	ThreadPoolConfig（core=50 / max=200 / queue=1000）

---

三、注意事项

• 阿里云 NLS 与 百炼 是两套不同凭证：NLS 用 AccessKey（AccessKeyId / Secret + Appkey），百炼用 sk- 开头的 API Key，不能混用。
• 百炼的 url 是业务空间专属 WebSocket 域名，换账号 / 换业务空间时同步替换其中的 {WorkspaceId}。
• 硅基流动的 api-key 在 ASR 与 NLU 两处可共用同一份（配置位置不同，值一致即可）。
• 大模型 LLM 走 OpenAI 兼容协议，可切 deepseek / 千问 / 智谱 等任意兼容端点，只需改 aihuman.llm.openai.*——该配置属暂未使用的内置 LLM 对话（前端对话使用的是业务后台 LLM 接口）；NLU 走 aihuman.nlu.*（硅基流动 / 智谱）。
• 音色不可跨平台 / 跨模型混用：NLS 音色只对 /tts/aliyun 生效，百炼 Qwen 音色对流式双工与预设语音下载（/tts/qwen/download）生效，混用会报 InvalidParameter（详见 module-tts）。
• 密钥类信息切勿提交进仓库；本表只记录配置位置。