> ## Content Index > Fetch the complete content index at: https://www.gogao.top/llms.txt > Use this file to discover other available public pages before exploring further. # HeyGem数字人项目 - URL: https://www.gogao.top/heygemshu-zi-ren-xiang-mu/ - Published: 2025-08-31T14:50:10.000Z - Updated: 2025-08-31T14:55:20.000Z - Description: 因工作需要，研究了一下数字人项目，HeyGem开源免费，生成效果还不错。经过研究实现了BS分离的部署模式，欢迎品尝。 - Author: 爱德姆 - Tags: AI & IT, #Import 2026-09-23 11:35 ## 一、部署 1. 客户端IP地址编辑 ``` export const serviceUrl = { face2face: isDev ? '' : '', tts: isDev ? '' : '' } ``` 1. 客户端资源文件处理 ``` export const assetPath = { model: isWin ? path.join('Z:', 'face2face', 'temp') : path.join(os.homedir(), 'heygem_data', 'face2face', 'temp'), // 模特视频 ttsProduct: isWin ? path.join('Z:', 'face2face', 'temp') : path.join(os.homedir(), 'heygem_data', 'face2face', 'temp'), // TTS 产物 ttsRoot: isWin ? path.join('Z:', 'voice', 'data') : path.join(os.homedir(), 'heygem_data', 'voice', 'data'), // TTS服务根目录 ttsTrain: isWin ? path.join('Z:', 'voice', 'data', 'origin_audio') : path.join(os.homedir(), 'heygem_data', 'voice', 'data', 'origin_audio') // TTS 训练产物 } ``` 1. 客户端文件路径映射 服务端将路径通过NFS或SMB曝露出来, 映射到Windows本地路径. 上面第二步客户端路径, 如: “Z:”, 即是映射到本地的网络驱动器. ## 二、接口文档 | 描述 | 语音模型训练（模特音频） | | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 请求路径 | [http://IP:18180/v1/preprocess\_and\_tran](http://ip:18180/v1/preprocess%5Fand%5Ftran?ref=gogao.top) | | 调用方式 | post，application/json | | 入参 | { “format”: “模特初始音频格式”, “reference\_audio”: “从TTS服务根目录到模特初始音频文件路径的相对路径”, “lang”: “语言”} | | 出参 | { “code”: 0, “msg”: “success”, “reference\_audio\_text”: “语音模型训练返回音频文本”, “asr\_format\_audio\_url”: “语音模型训练返回音频路径”} | | 调用示例 | url: [http://192.168.3.231:18180/v1/preprocess\_and\_tran入参：{“format”:“wav”,“reference\_audio”:“origin\_audio/20250729104817075.wav”,“lang”:“zh”}出参：{“code”:0,“msg”:“success”,“reference\_audio\_text”:“基肯肯雅热，主要通过埃及伊文和白文译文叮咬传播。”,“asr\_format\_audio\_url”:“/code/sessions/20250729/0f0e3977679c4359b923a2204e9a316e/format\_denoise\_20250729093333073\_part0.wav”}](http://192.168.3.231:18180/v1/preprocess%5Fand%5Ftran%E5%85%A5%E5%8F%82%EF%BC%9A%7B%E2%80%9Cformat%E2%80%9D:%E2%80%9Cwav%E2%80%9D,%E2%80%9Creference%5Faudio%E2%80%9D:%E2%80%9Corigin%5Faudio/20250729104817075.wav%E2%80%9D,%E2%80%9Clang%E2%80%9D:%E2%80%9Czh%E2%80%9D%7D%E5%87%BA%E5%8F%82%EF%BC%9A%7B%E2%80%9Ccode%E2%80%9D:0,%E2%80%9Cmsg%E2%80%9D:%E2%80%9Csuccess%E2%80%9D,%E2%80%9Creference%5Faudio%5Ftext%E2%80%9D:%E2%80%9C%E5%9F%BA%E8%82%AF%E8%82%AF%E9%9B%85%E7%83%AD%EF%BC%8C%E4%B8%BB%E8%A6%81%E9%80%9A%E8%BF%87%E5%9F%83%E5%8F%8A%E4%BC%8A%E6%96%87%E5%92%8C%E7%99%BD%E6%96%87%E8%AF%91%E6%96%87%E5%8F%AE%E5%92%AC%E4%BC%A0%E6%92%AD%E3%80%82%E2%80%9D,%E2%80%9Casr%5Fformat%5Faudio%5Furl%E2%80%9D:%E2%80%9C/code/sessions/20250729/0f0e3977679c4359b923a2204e9a316e/format%5Fdenoise%5F20250729093333073%5Fpart0.wav%E2%80%9D%7D?ref=gogao.top) | | | | | 描述 | 文本合成音频 | | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 请求路径 | [http://IP:18180/v1/invoke](http://ip:18180/v1/invoke?ref=gogao.top) | | 调用方式 | post，application/json | | 入参 | { “speaker”: “UUID”, //标志一个音频合成请求，保持唯一即可 “text”: “音频合成文本”, “format”: “wav”, //固定传参 “topP”: 0.7, // 固定传参 “max\_new\_tokens”: 1024, // 固定传参 “chunk\_length”: 100, // 固定传参 “repetition\_penalty”: 1.2, // 固定传参 “temperature”: 0.7, // 固定传参 “need\_asr”: false, // 固定传参 “streaming”: false, // 固定传参 “is\_fixed\_seed”: 0, // 固定传参 “is\_norm”: 1, // 固定传参 “reference\_audio”: “语音模型训练返回音频路径”, “reference\_text”: “语音模型训练返回音频文本”} | | 出参 | 合成音频文件的二进制数据 | | 调用示例 | url: [http://192.168.3.231:18180/v1/invoke入参：](http://192.168.3.231:18180/v1/invoke%E5%85%A5%E5%8F%82%EF%BC%9A?ref=gogao.top){“speaker”:“ef8a5a72-e510-4de7-8e53-5580c9ec33e4”,“text”:” 延续护理专科为出院患者提供过渡期专业照护。若您近期手术出院、患慢性病或需长期康复，可挂此号。医护团队将联合制定居家护理计划，指导用药、伤口管理、康复训练及健康监测，减少再入院风险。尤其适合高龄、行动不便或照护资源不足的患者。助您平稳过渡至家庭康复。“,”format”:“wav”,“topP”:0.7,“max\_new\_tokens”:1024,“chunk\_length”:100,“repetition\_penalty”:1.2,“temperature”:0.7,“need\_asr”:false,“streaming”:false,“is\_fixed\_seed”:0,“is\_norm”:1,“reference\_audio”:“/code/sessions/20250729/0f0e3977679c4359b923a2204e9a316e/format\_denoise\_20250729093333073\_part0.wav”,“reference\_text”:“基肯肯雅热，主要通过埃及伊文和白文译文叮咬传播。”} 出参： | | 描述 | 提交tts视频合成任务 | | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 请求路径 | /easy/submit | | 调用方式 | post，application/json | | 入参 | { “audio\_url”: “音频路径”, “video\_url”: “视频路径”, “code”: “合成视频编码”, “chaofen”: 0, “watermark\_switch”: 0, “pn”: 1} | | 出参 | { “code”: 10000, “data”: {}, “msg”: 10000, “success”: true} | | 调用示例 | url: [http://192.168.3.231:8383/easy/submit入参：{“audio\_url”:“82e8ed51-7e47-4069-8640-a51ba2a352a1.wav”,“video\_url”:“20250729104817075.mp4”,“code”:“243c7f9c-98f3-43cb-86d5-d19ecaad341c”,“chaofen”:0,“watermark\_switch”:0,“pn”:1}出参：{“code”:10000,“data”:{},“msg”:10000,“success”:true](http://192.168.3.231:8383/easy/submit%E5%85%A5%E5%8F%82%EF%BC%9A%7B%E2%80%9Caudio%5Furl%E2%80%9D:%E2%80%9C82e8ed51-7e47-4069-8640-a51ba2a352a1.wav%E2%80%9D,%E2%80%9Cvideo%5Furl%E2%80%9D:%E2%80%9C20250729104817075.mp4%E2%80%9D,%E2%80%9Ccode%E2%80%9D:%E2%80%9C243c7f9c-98f3-43cb-86d5-d19ecaad341c%E2%80%9D,%E2%80%9Cchaofen%E2%80%9D:0,%E2%80%9Cwatermark%5Fswitch%E2%80%9D:0,%E2%80%9Cpn%E2%80%9D:1%7D%E5%87%BA%E5%8F%82%EF%BC%9A%7B%E2%80%9Ccode%E2%80%9D:10000,%E2%80%9Cdata%E2%80%9D:%7B%7D,%E2%80%9Cmsg%E2%80%9D:10000,%E2%80%9Csuccess%E2%80%9D:true?ref=gogao.top)} | | 描述 | 查询tts视频合成任务状态 | | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 请求路径 | /easy/query | | 调用方式 | get | | 入参 | code=合成任务编码 | | 出参 | { “code”: 状态码 10000-成功, “data”: { “code”: “合成任务编码”, “cost”: {}, “height”: 视频高度, “msg”: “任务进度描述”, “progress”: 任务进度数, “result”: “生成视频保存路径”, “status”: 任务状态 1-进行中 2-已完成, “video\_duration”: 视频长度, “width”: 视频宽度 }, “msg”: ““,”success”: 是否成功 true-是} | | 调用示例 | url: [http://192.168.3.231:8383/easy/query入参：code=243c7f9c-98f3-43cb-86d5-d19ecaad341c出参1：{“code”:10000,“data”:{“code”:“243c7f9c-98f3-43cb-86d5-d19ecaad341c”,“msg”:“视频特征提取完成”,“progress”:20,“result”:““,”status”:1},“msg”:““,”success”:true](http://192.168.3.231:8383/easy/query%E5%85%A5%E5%8F%82%EF%BC%9Acode=243c7f9c-98f3-43cb-86d5-d19ecaad341c%E5%87%BA%E5%8F%821%EF%BC%9A%7B%E2%80%9Ccode%E2%80%9D:10000,%E2%80%9Cdata%E2%80%9D:%7B%E2%80%9Ccode%E2%80%9D:%E2%80%9C243c7f9c-98f3-43cb-86d5-d19ecaad341c%E2%80%9D,%E2%80%9Cmsg%E2%80%9D:%E2%80%9C%E8%A7%86%E9%A2%91%E7%89%B9%E5%BE%81%E6%8F%90%E5%8F%96%E5%AE%8C%E6%88%90%E2%80%9D,%E2%80%9Cprogress%E2%80%9D:20,%E2%80%9Cresult%E2%80%9D:%E2%80%9C%E2%80%9C,%E2%80%9Dstatus%E2%80%9D:1%7D,%E2%80%9Cmsg%E2%80%9D:%E2%80%9C%E2%80%9C,%E2%80%9Dsuccess%E2%80%9D:true?ref=gogao.top)}出参2：{“code”:10000,“data”:{“code”:“243c7f9c-98f3-43cb-86d5-d19ecaad341c”,“cost”:{},“height”:1248,“msg”:“任务完成”,“progress”:100,“result”:“/243c7f9c-98f3-43cb-86d5-d19ecaad341c-r.mp4”,“status”:2,“video\_duration”:27492,“width”:704},“msg”:““,”success”:true} |