VCClient 实时变声器选对发行版用 curl 调通第一次请求【免费下载链接】voice-changerリアルタイムボイスチェンジャー Realtime Voice Changer项目地址: https://gitcode.com/gh_mirrors/vo/voice-changerVCClient 是一个把麦克风实时语音变成 AI 声音的客户端 服务端项目。做游戏语音、直播变声的人只需要回答四个问题下哪个包、怎么起服务、API 怎么调、声音没变怎么查。架构鸟瞰声音去了哪又从哪里回来别先啃细节记住这条链路就够了麦克风 → GUI → (1) 转换前语音 → 服务器 → (2) 转换后语音 → GUI → (3) → 扬声器GUI客户端管麦克风的采集和结果的回放服务器管加载模型和实时推理。两种跑法standalone 模式在本机闭环network 模式把服务器放到远端机器和游戏同时跑时推理负载走网络卸出去不抢本机 GPU/CPU。服务端是 FastAPI Socket.IOuvicorn 托管默认 18888 端口RVC、Beatrice、MMVC、so-vits-svc、DDSP-SVC 这些模型实现以子目录形式放在server/voice_changer/下类型统一登记在 server/const.py 的VoiceChangerType里。std 和 cuda 到底怎么选选错发行版会直接导致模型加载失败所以先看对应关系自 v2.2.1 起不同发行版支持的 AI 模型不同。只用 Beatrice → 下 std 就够Windows、macOS(M1)、Linux(x86-64 / aarch64) 都有 std 包要用 RVC → 选 cuda仅 Windows或 onnxWindows / macOS M1要跑 MMVC、so-vits-svc、DDSP-SVC 这类传统模型 → 它们属于 v1 产品线v2 主攻 RVC 和 Beatrice v2一句话带过即可不用纠结。发行版平台支持模型stdwin / mac(m1) / linux(x86-64, aarch64)BeatricecudawinBeatrice, RVConnxwin / mac(m1)Beatrice, RVC预打包二进制只覆盖 Windows 和 M1 MacLinux 用户需要 clone 仓库自己跑。从 clone 到验证端口把服务跑起来第一步获取代码。Windows / M1 Mac 直接下预打包包Linux 走这条git clone https://gitcode.com/gh_mirrors/vo/voice-changer第二步装依赖、启动。官方开发文档推荐 Python 3.10 环境cd voice-changer/server pip install -r requirements.txt python3 MMVCServerSIO.py -p 18888你只需要关心这 5 个参数其余--hubert_base、--rmvpe等预训练权重路径以及--sample_mode、--allowed-origins归为高级选项先用默认值参数默认值作用-p18888服务端口--host127.0.0.1设为0.0.0.0时外部机器才能连上--httpsfalse为 true 时走 HTTPS自签名证书自动生成--model_dirmodel_dir模型文件目录--logLevelerror排障时建议提到 info完整参数表在 server/MMVCServerSIO.py 的setupArgParser()里。服务启动时会先自动下载 RVC 权重和 Tsukuyomi-chan_o、Amitaro_o 等示例模型清单见 server/const.py下载完才进入监听。第三步验证。能打开http://127.0.0.1:18888/api/hello并收到{result: Index}说明服务活着浏览器再访问http://127.0.0.1:18888/front就是 GUI。Windows / macOS 下服务器进程还会自动拉起原生客户端窗口踩坑提醒macOS 上软件未签名系统弹安全警告时按住 Control 键再点图标即可运行。curl 调通第一次请求语音转换端点只有一个POST /test。一次请求的完整生命周期长这样。请求体——buffer是base64 编码的 16bit 小端 PCM不要带 wav 头{ timestamp: 1700000000, buffer: AAAAAAAAAAAA... }响应体——转换后的音频同样是 base64 PCM{ timestamp: 1700000000, changedVoiceBase64: AAAAAAAAAAAA... }说白了把buffer换成你自己音频的 base64 就能跑。一条可直接执行的命令# 1) wav 转成 16bit 小端 PCM 并 base64 ffmpeg -i input.wav -f s16le -acodec pcm_s16le -ar 44100 -ac 1 - | base64 -w0 buffer.b64 # 2) 发请求并把返回解码成 PCM curl -s -X POST http://127.0.0.1:18888/test \ -H Content-Type: application/json \ -d {\timestamp\: $(date %s), \buffer\: \$(cat buffer.b64)\} \ | python3 -c import json,sys,base64; sys.stdout.buffer.write(base64.b64decode(json.load(sys.stdin)[changedVoiceBase64])) output.pcm # 3) 听一下 ffmpeg -f s16le -ar 44100 -ac 1 -i output.pcm -y output.wav多语言 SDK 不用记思路都一样麦克风或文件音频编成 int16 PCM → base64 → POST/test→ 解码返回的changedVoiceBase64播放或落盘。这就是给游戏语音插件、直播工具、自定义客户端提供的稳定入口。声音没变过来先查哪一段症状 → 先查什么 → 动作。官方排障法的核心就一句先定位声音卡在哪一段采集/传输/推理/回放再只修那一段。声音一点都没变、像是原声直通→ 大概率是 (1) 段GUI→服务器没把真实人声送出去。开 Analyzer 的 Sampling 试转一下停掉后看in录音若in里录到的就是你本人声音说明 (1) 正常故障在推理侧若in是空的或噪声先换一段语音文件测试把流程和麦克风解耦再拿录音程序确认麦克风本身是否工作正常。声音变了但发闷/断音/节奏错乱→ 大概率是 (2) 段服务器推理后出了问题。开 Analyzer Sampling停掉后听out录音out是 (2) 的转换后声音应能听到 AI 后的音色。若out已正常但扬声器听着不对说明 (3) 段服务器→GUI→扬声器回传或回放异常。GUI 里完全听不到转换声→ 用 Audio Output 的 output record 录一段停止后会下载.wav这就是送达 GUI 的转换后语音拿它和你期望的转换音色对比能区分没送过来还是送过来了但设备没播。 定位到声音走到哪一步为止正常后只修之后那一段别全链路一起翻事倍功半。版本与更新只记对你有用的那几条v.2.2.2-beta首次发布 std_win / std_mac / std_lin_aarch64 三个标准包并新增 Beatrice v2.0.0-rc0 支持——这是发行版按模型分化的分水岭之后不同版本发布的包可能不同。v.2.0.78-beta修复 RVC 模型上传错误支持 ver.1.x 并行运行chunk size 可选范围也扩大了——跑 RVC 或要 v1/v2 共存的话这条直接相关。v.2.0.73-beta修了 Beatrice v2 的 pitch、formant 不生效、以及 Applio embedder 模型无法生成 ONNX 两个 bug还能下载编辑后的 Beatrice 模型。⚠️ v.2.0.77-beta 是 RTX 5090 专属实验性构建开发者本身没有这张卡未经实机验证谨慎尝鲜。合规速查素材许可与免责示例模型用的是免费角色语音素材公开发布前务必过一遍这三行Tsukuyomi-chanCV. 夢前黎→ 禁止用于批判/攻击他人、号召特定政治/宗教/思想立场、无分级公开刺激性表达、以允许他人二次利用的形式公开作为鉴赏用作品分发/销售不在此限。Amitaro小春音アミ→ 允许转成自己的声音使用但必须明确标注经过了音质转换让任何人都能看出不是本人在说话且内容须在素材利用规约范围内。Kikoto Mahiro黄琴まひろ→ 遵循 Replicadoll 的利用规约。一句话免责对本软件使用或无法使用造成的任何直接、间接、波及性、结果性或特殊损害项目方不承担任何责任。 公开发布转换后语音前逐条核对上述素材条款合规责任自负。【免费下载链接】voice-changerリアルタイムボイスチェンジャー Realtime Voice Changer项目地址: https://gitcode.com/gh_mirrors/vo/voice-changer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考