RVC Next

命令参考

本页按命令树列出 rvc-next 的每条命令和子命令，内容来自各命令的 --help 输出。命令和子命令在帮助中按字母顺序排列，本页按用途分组。

所有命令都接受下面两个选项，表格里不再重复：

选项说明
--debug打印调试日志
--help显示帮助并退出

表中"默认值"一栏为"—"时表示不给出就不生效，或沿用预设、设置里的值（会在说明里写明）。范围写成 [a, b]。

根命令

rvc-next [OPTIONS] COMMAND [ARGS]...

基于检索的语音转换：转换、实时、分离和训练。

选项说明
--install-completion为当前 shell 安装补全
--show-completion显示当前 shell 的补全脚本，用于复制或自定义安装

服务器与系统

webui

启动服务器并打开 Web UI。

rvc-next webui [OPTIONS]
选项说明默认值
--host <str>绑定的地址取自设置 server.host（127.0.0.1）
--port <int>第一个尝试的端口，[0, 65535]；0 由系统任选取自设置 server.port（7868）
--strict-port / --no-strict-port端口被占用时直接失败，而不是尝试下一个端口取自设置 server.strict_port（关）
--open / --no-open在浏览器中打开 Web UI取自设置 server.open_browser（开）
--data-dir <directory>数据目录（设置、数据库、模型、结果）RVC_NEXT_DATA_DIR 或系统默认位置
--config-dir <directory>存放 settings.toml 的文件夹RVC_NEXT_CONFIG_DIR 或数据目录
--api-prefix <str>把 API、socket 和 Web UI 放到这个路径下，例如 /voice无
--ssl-certfile <file>PEM 证书：以 HTTPS 提供服务（从其他电脑在实时变声中使用 本浏览器 时需要）server.ssl_certfile
--ssl-keyfile <file>证书的私钥server.ssl_keyfile

端口被占用时依次尝试后面的端口（最多 20 个），并在日志里提示实际使用的端口；全部失败时以退出码 3 结束。绑定到非本机地址时会在日志中警告，不需要访问令牌（见 远程访问与安全）。启动成功后标准输出打印一行 SERVER_READY url=http://...。

rvc-next webui
rvc-next webui --port 8000 --no-open
rvc-next webui --data-dir D:/rvc-next-data

version

显示 rvc-next 及其主要组件（torch、transformers、faiss-cpu、librosa、av、sounddevice、pymss、fastapi 等）的版本。

选项说明
--json打印 JSON

env

列出 rvc-next 读取的环境变量，以及当前已设置的 RVC_NEXT_* 变量（名称含 TOKEN 的值显示为 ***）。

选项说明
--json打印 JSON

doctor

检查 Python、torch 及其 GPU 后端（CUDA、ROCm、XPU）、DirectML、ffmpeg、音频设备、资源，以及 GPU 规则选中的设备和精度，最后列出发现的问题和修复命令。

选项说明
--json打印 JSON
rvc-next doctor

转换与分离

convert

用一个音色转换音频文件或文件夹。参数从音色的默认预设开始，命令行给出的选项覆盖对应的值。

rvc-next convert [OPTIONS] INPUTS...
参数说明
INPUTS...音频文件或文件夹（必填，可多个）
选项说明默认值
-v, --voice <str>音色 id、名称或 .pth 路径（必填）—
-o, --output <directory>输出文件夹数据目录中该任务的文件夹
--preset <str>以这个预设为起点，而不是音色的默认预设音色的默认预设
--index <file>用路径给出 .pth 音色时使用的索引—
--speaker <int>多说话人音色的说话人 id，[0, 109]取自预设
--pitch <float>音高偏移（半音），[-24, 24]取自预设
--formant <float>共振峰偏移（半音），[-2, 2]取自预设
--f0 <str>音高算法：pm、rmvpe、fcpe、crepe、crepe-tiny 或 swift取自预设
--index-rate <float>索引强度，[0, 1]取自预设
--protect <float>辅音保护，[0, 0.5]；0.5 为关闭取自预设
--rms-mix <float>响度匹配，[0, 1]；1 保持转换后的响度取自预设
--unvoiced <mode>无音高帧：protect、zero 或 original，见无音高帧取自预设
--autotune <float>把音拉向最近的半音，[0, 1]；0 为关闭取自预设
--auto-pitch <mode>off、semitone 或 octave：再移调，使输入的中位音高落到目标上；见自动定调取自预设
--auto-pitch-target <float>自动定调的目标音高（Hz），[0, 1000]；0 为音色自己的，否则 155取自预设
--high-register <mode>RMVPE 约 1040 Hz 以上：off、true_pitch 或 fold，见极高音取自预设
--f0-ceiling <float>true_pitch 写入的最高音高，[1000, 2000] Hz取自预设
--separate <str>先用这个分离预设分离，再转换人声—
--remix加回伴奏（需要 --separate）关
--remix-gain <float>伴奏增益（dB）0.0
--format <str>wav、flac、mp3、m4a 或 ogg（Opus）设置 convert.output_format（wav）
--resample <int>把结果重采样到这个采样率，至少 16000音色自身的采样率
--denoise <float>对转换结果降噪，[0, 1]；0 为关闭0
--effect <spec>转换结果上的效果，可重复，按顺序处理：KIND 或 KIND:NAME=VALUE,...，例如 --effect compressor --effect reverb:room_size=0.6,wet_level=0.3；effects 列出全部效果。需要 rvc-next[effects]无
--recursive / --no-recursive进入文件夹输入的子文件夹--no-recursive
--overwrite / --no-overwrite替换输出文件夹里已有的文件--no-overwrite
--preview <float>只转换前 N 秒，[1, 120]—
--json以 JSON 打印完成的任务关

结束后逐行打印输出文件的路径。

rvc-next convert vocal.wav -v "我的音色" --pitch 12
rvc-next convert ./in --recursive -v kikiv1 --f0 fcpe -o ./out --format mp3
rvc-next convert song.flac -v ./voice.pth --index ./added.index --separate vocals --remix

analyse

显示音频文件的时长、格式和中位音高，并可写出它的音高曲线（SwiftF0，在处理器上计算；10 ms 一步）。

rvc-next analyse [OPTIONS] PATH
选项说明
--csv <path>把音高曲线写成 time_s,f0_hz（没有音高处为 0）
--json输出完整分析，包括频谱图（base64）

effects

列出 convert --effect 和 live run --effect 可用的效果，以及每个参数的默认值和范围，并说明是否已安装 pedalboard。

rvc-next effects [--json]

separate

分离人声、伴奏和混响。可以用单个预设，也可以用串联预设。

rvc-next separate [OPTIONS] [INPUTS]...
参数说明
INPUTS...音频文件或文件夹（不用 --list 时必填）
选项说明默认值
-p, --preset <str>预设 id；用 --list 查看设置 separation.default_preset（vocals）
-o, --output <directory>输出文件夹数据目录中该任务的文件夹
--format <str>wav、flac、mp3、m4a 或 ogg（Opus）设置 separation.output_format（flac）
--recursive / --no-recursive进入子文件夹--no-recursive
--list列出预设并退出关
--json打印 JSON关

内置预设：vocals、vocals-aggressive、dereverb、dereverb-aggressive、karaoke，以及串联预设 vocals-clean（人声 → 去混响）和 lead-clean（人声 → 主唱 → 去混响）。导入的分离模型以 user-<名称> 作为预设 id。

rvc-next separate --list
rvc-next separate song.mp3 -p vocals-clean -o ./stems

文字转语音：tts

用微软 Edge 的在线语音把文字读出来（需要 rvc-next[tts]）；文字会发送到微软的语音服务。

tts voices

列出发音人：每行一个，包括 ID、性别和语言。列表缓存一周。

选项说明
--locale <str>只列出地区代码以此开头的发音人，例如 en、zh-CN
--refresh重新获取列表
--json以 JSON 输出

tts speak

朗读文字并保存为 MP3，输出文件路径。

rvc-next tts speak [OPTIONS] TEXT
参数 / 选项说明默认值
TEXT要朗读的文字；- 表示从标准输入读取—
--voice <id>tts voices 中的发音人 ID（必填）—
-o, --output <file>把 MP3 写到这里存放在数据目录的上传文件中
--rate <int>语速变化（百分比），[-50, 100]0
--pitch <int>音高变化（Hz），[-50, 50]0
rvc-next tts speak "你好" --voice zh-CN-XiaoxiaoNeural -o hello.mp3
rvc-next convert hello.mp3 -v "我的音色"

设置：config

显示和修改设置。设置项见 配置与环境变量。

config show

显示当前生效的设置（默认值、settings.toml 和环境变量合并后的结果）。访问令牌只显示为是否已设置。

选项说明
--json打印 JSON

config get

打印一个设置。

rvc-next config get KEY
参数说明
KEY点分隔的键，例如 server.port（必填）

config set

修改一个设置并保存到 settings.toml。

rvc-next config set KEY VALUE
参数说明
KEY点分隔的键，例如 server.port 或 compute.device（必填）
VALUE新值。按 JSON 解析（数字、true/false、列表）；null 清除（必填）

如果同名环境变量覆盖了这个设置，命令会提示"An environment variable overrides this setting."。

rvc-next config set compute.device cpu
rvc-next config set server.access_token "换成一个长随机字符串"
rvc-next config set paths.browse_roots '["D:/music", "E:/datasets"]'

config path

打印设置文件的路径。

资源：assets

HuBERT、RMVPE、底模和分离模型权重。

assets list

显示每个资源的 id、名称、分组、大小和状态（已安装、缺失、损坏），以及当前的下载仓库。

选项说明
--json打印 JSON

assets download

下载资源：断点续传，并校验 SHA-256。

rvc-next assets download [OPTIONS] [IDS]...
参数说明
IDS...资源 id；见 rvc-next assets list
选项说明默认值
--group <str>inference（HuBERT 和各音高模型）、embedder、community、training、separation 或 all既没有 id 也没有分组时为 inference
--source <str>下载端点：huggingface、hf-mirror 或 custom（保存到设置）设置 downloads.source
--repository <str>rvc-model 或 official（保存到设置）设置 downloads.repository

资源 id：hubert、rmvpe、rmvpe-onnx、fcpe、crepe、crepe-tiny、pretrained-v1-32k、pretrained-v1-40k、pretrained-v1-48k、pretrained-v2-32k、pretrained-v2-40k、pretrained-v2-48k、separation-vocals、separation-vocals-aggressive、separation-dereverb、separation-dereverb-aggressive、separation-karaoke，内容特征模型 embedder-spin、embedder-spin-v2、embedder-chinese-hubert-base、embedder-japanese-hubert-base、embedder-korean-hubert-base（分组 embedder），以及社区底模 community-<名称>-<采样率>（分组 community；rvc-next assets list 会列出）。任何分组都不包括只在 DirectML 上使用的 rmvpe-onnx；inference 分组是 hubert、rmvpe、fcpe、crepe 和 crepe-tiny。all 不包含 embedder 和 community。

rvc-next assets download
rvc-next assets download fcpe pretrained-v2-40k
rvc-next assets download --group separation --source hf-mirror

assets verify

用校验和检查已安装的资源。不给 id 和分组时检查所有已安装或已损坏的资源。

rvc-next assets verify [OPTIONS] [IDS]...
参数说明
IDS...资源 id
选项说明
--group <str>inference（HuBERT 和各音高模型）、embedder、community、training、separation 或 all

模型：model

音色库。

model list

列出某一类模型。

选项说明默认值
--json打印 JSON关
--all包括已隐藏的旧版音色关
--type <str>voice、index（未分配的索引）、base 或 separationvoice

model info

显示一个音色：采样率、版本、音高引导、说话人、索引和默认预设。

rvc-next model info [OPTIONS] VOICE
参数说明
VOICE音色 id、名称或 .pth 路径（必填）
选项说明
--speakers只列出说话人
--json打印 JSON

model import

导入模型。每个文件按内容识别，索引与音色的配对不依赖文件名。

rvc-next model import [OPTIONS] PATHS...
参数说明
PATHS...音色（.pth）、索引、.zip 压缩包、底模（G/D）、分离模型（.ckpt + .yaml）、文件夹、一个 RVC 安装，或链接：Hugging Face 的文件、仓库和文件夹，Google Drive 文件，任意 http(s) 文件（必填；见从链接添加）
选项说明
--name <str>只导入一个音色时为它命名
--index <path>附加到唯一一个音色的 .index，不管文件名是什么
--pair <str>按文件名指定配对：VOICE.pth=FILE.index[:spkN]；可重复
--keep-unassigned无法确定配对的索引放进未分配列表
--extract把训练生成器（G）提取为音色，而不是作为底模导入
--json打印 JSON

有索引无法确定配对、或分离检查点缺少配置时，命令打印文件表和索引表（含兼容的音色），然后以退出码 3 结束，不导入任何文件。给一个 RVC 安装的根目录时，复制其中 assets/weights/*.pth 和 assets/indices、logs 下的 added_*.index。

rvc-next model import voice.zip
rvc-next model import model.pth --index ./whatever.index --name "我的音色"
rvc-next model import a.pth b.pth x.index y.index --pair a.pth=x.index --pair b.pth=y.index
rvc-next model import G_2333333.pth D_2333333.pth            # 作为底模
rvc-next model import G_2333333.pth --extract --name "试验"   # 提取为音色

model catalog

列出可以下载的现成音色（RVC 官方示例音色）。

选项说明
--json打印 JSON

model download

把现成音色连同索引下载到音色库。

rvc-next model download [OPTIONS] [IDS]...
参数说明
IDS...rvc-next model catalog 中的音色 id
选项说明
--all下载所有还不在音色库中的目录音色

必须给出 id 或 --all。

model edit

重命名音色、修改描述或为说话人命名（保存在 .pth 旁边，不改动 .pth）。

rvc-next model edit [OPTIONS] VOICE
参数说明
VOICE音色 id 或名称（必填）
选项说明
--name <str>新名称
--description <str>新描述
--speaker-name <str>ID=名称；可重复
rvc-next model edit duet --speaker-name 0=Alice --speaker-name 1=Bob

model export

把音色写成 zip，以便在另一台电脑上导入：<名称>/<名称>.pth（副本中写入了说话人名称）及其索引（<名称>.index、<名称>_spkid<N>.index）。

rvc-next model export [OPTIONS] VOICE
参数说明
VOICE音色 id 或名称（必填）
选项说明默认值
-o, --output <path>要写入的 zip当前文件夹中的 <名称>.zip

model remove

移除一个音色：音色库中的音色移到回收站，旧版音色只是隐藏。

rvc-next model remove [OPTIONS] VOICE
参数说明
VOICE音色 id 或名称（必填）
选项说明
-y, --yes不询问

model merge

按权重融合两个音色，生成一个新的音色。

rvc-next model merge [OPTIONS] A B
参数说明
A第一个音色（必填）
B第二个音色（必填）
选项说明默认值
--name <str>新音色的名称（必填）—
--alpha <float>第一个音色的权重，[0, 1]0.5
--info <str>写入模型的文字空

model extract

从训练检查点提取小模型到音色库。

rvc-next model extract [OPTIONS] CHECKPOINT
参数说明
CHECKPOINT一个 G_*.pth 检查点，或 <实验>/<文件>（必填）
选项说明默认值
--name <str>新音色的名称（必填）—
--sr <str>无法从实验读取时指定 32k、40k 或 48k从实验读取
--version <str>v1 或 v2从实验读取
--pitch / --no-pitch音高引导从实验读取
--info <str>写入模型的文字空
rvc-next model extract alice/G_2333333.pth --name "Alice e100"

model index

检索索引。

model index attach

把一个索引文件附加到音色。

rvc-next model index attach [OPTIONS] VOICE FILE
参数说明
VOICE音色 id 或名称（必填）
FILEadded_*.index 文件（必填）
选项说明
--speaker <int>作为这个说话人自己的索引附加

model index assign

把一个未分配的索引附加到音色；索引必须与音色的版本相符。

rvc-next model index assign [OPTIONS] INDEX_ID VOICE
参数说明
INDEX_ID一个未分配的索引（见 rvc-next model list --type index，必填）
VOICE音色 id 或名称（必填）
选项说明
--speaker <int>作为这个说话人自己的索引附加

model index build

用实验已提取的特征为音色构建索引。

rvc-next model index build [OPTIONS] VOICE
参数说明
VOICE音色 id 或名称（必填）
选项说明
--experiment <str>使用哪个实验的特征（必填）

预设：preset

保存的音色参数。

preset list

选项说明
--voice <str>只列出这个音色的预设和全局预设
--json打印 JSON

preset save

把音色参数保存为预设。从音色的默认预设开始（不指定音色时从设置 convert.default_params 开始），再应用给出的选项。

rvc-next preset save [OPTIONS] NAME
参数说明
NAME预设名称（必填）
选项说明
--voice <str>预设所属的音色；省略则为全局预设
--default设为该音色的默认预设
--speaker <int>多说话人音色的说话人 id，[0, 109]
--pitch <float>音高偏移（半音），[-24, 24]
--formant <float>共振峰偏移（半音），[-2, 2]
--f0 <str>音高算法：pm、rmvpe、fcpe、crepe、crepe-tiny 或 swift
--index-rate <float>索引强度，[0, 1]
--protect <float>辅音保护，[0, 0.5]；0.5 为关闭
--rms-mix <float>响度匹配，[0, 1]；1 保持转换后的响度
--unvoiced <mode>无音高帧：protect、zero 或 original，见无音高帧
--autotune <float>把音拉向最近的半音，[0, 1]；0 为关闭
--auto-pitch <mode>off、semitone 或 octave：再移调，使输入的中位音高落到目标上；见自动定调
--auto-pitch-target <float>自动定调的目标音高（Hz），[0, 1000]；0 为音色自己的，否则 155
--high-register <mode>RMVPE 约 1040 Hz 以上：off、true_pitch 或 fold，见极高音
--f0-ceiling <float>true_pitch 写入的最高音高，[1000, 2000] Hz
rvc-next preset save "男转女" --voice "我的音色" --pitch 12 --default

preset remove

rvc-next preset remove [OPTIONS] NAME
参数说明
NAME预设 id 或名称（必填）
选项说明
--voice <str>预设所属的音色

训练：train

训练实验。

train list

列出实验：采样率、版本、音高引导、单/多说话人、各阶段状态（✓ 完成、~ 已过期、… 运行中、✗ 失败、· 未运行、- 已跳过）和最近活动时间。

选项说明
--json打印 JSON

train new

新建实验。未给出的项取自设置的 training 组。

rvc-next train new [OPTIONS] NAME
参数说明
NAME实验名称（必填）
选项说明默认值
--dataset <directory>数据集文件夹（单说话人）；配合 --multi-speaker 时为 名称_ID_重复 文件夹的根目录—
--multi-speaker从 --dataset 的 名称_ID_重复 子文件夹读取说话人关
--sr <str>32k、40k 或 48ktraining.sample_rate（40k）
--version <str>v1 或 v2training.version（v2）
--no-pitch不使用音高引导训练使用音高引导
--f0 <str>pm、rmvpe、fcpe、crepe、crepe-tiny 或 swifttraining.f0_method（auto：有 GPU 用 rmvpe，否则 pm）
--embedder <str>内容特征：contentvec、spin、spin-v2、chinese-hubert-base、japanese-hubert-base 或 korean-hubert-base（后三个只用于 v2）contentvec
--clean <str>切片前先用这个分离预设处理数据集，例如 vocals-clean—
--json打印 JSON关

train dataset

实验的数据集。

train dataset scan

报告片段数量、总时长、采样率，以及过短、过长、削波或静音的片段。

rvc-next train dataset scan [OPTIONS] NAME
参数说明
NAME实验名称（必填）
选项说明
--json打印 JSON

train dataset speakers

显示说话人表，或从文件夹填充。

rvc-next train dataset speakers [OPTIONS] NAME
参数说明
NAME实验名称（必填）
选项说明
--from-folders <directory>从 名称_ID_重复 子文件夹填充说话人表
--json打印 JSON

train run

运行阶段：不指定时运行所有未完成（或输入已改变）的阶段，也可以只运行指定阶段。

rvc-next train run [OPTIONS] NAME
参数说明
NAME实验名称（必填）
选项说明默认值
--stage <str>clean、slice、f0、features、fit、index 或 all；可重复全部需要运行的阶段
--epochs <int>总轮数，至少 1实验中保存的值（新实验取 training.epochs，20）
--batch-size <int>批大小，至少 1实验中保存的值（自动：最小显卡的显存 GiB 数除以 2）
--save-every <int>每 N 轮保存，至少 1实验中保存的值（新实验取 training.save_every，5）
--gpus <str>auto、cpu，或 0-1 这样的 GPU 编号；保存到实验中实验中保存的值（新实验取 training.gpus，auto）
--force / --no-force即使输入没有变化也运行所选阶段--no-force
--base <str>底模 id（见 rvc-next model list --type base）；保存到实验中按采样率、版本和音高引导自动选择
--precision <str>auto（所有显卡都支持时用 fp16）、fp32 或 bf16；保存到实验中实验中保存的值（auto）
--tf32 / --no-tf32在 NVIDIA 显卡上使用 TF32 运算；保存到实验中实验中保存的值（关）
--checkpointing / --no-checkpointing梯度检查点：显存更少、每步更慢；保存到实验中实验中保存的值（关）
--fresh-speakers / --no-fresh-speakers使用新的说话人向量而不是底模的；保存到实验中实验中保存的值（关）
--samples / --no-samples每次保存时渲染一段训练样例；保存到实验中实验中保存的值（开）
--cut <mode>切分方式：auto（先按静音切开再切成片段）、fixed（直接按长度切）或 none（已切好）；保存到实验中实验中保存的值（auto）
--chunk-seconds <float>片段长度，[0.5, 10]；保存到实验中有 GPU 时 3.7 秒，没有时 3.0 秒
--overlap <float>片段之间的重叠（秒），[0, 0.4]；保存到实验中0.3
--highpass / --no-highpass切片前的 48 Hz 高通；保存到实验中开
--normalize <mode>响度：slice（原版）、file 或 none；保存到实验中slice
--dataset-denoise <float>切片前对每段录音降噪，[0, 1]；保存到实验中0

--epochs、--batch-size、--save-every 和 --base 会写入实验的训练设置。增加 --epochs 后，即使训练阶段已完成，不带 --stage 运行也会再次运行训练阶段。

rvc-next train run alice
rvc-next train run alice --stage fit --epochs 300 --batch-size 6
rvc-next train run alice --stage index --force

train status

显示阶段、检查点和最近一次的指标。

rvc-next train status [OPTIONS] NAME
参数说明
NAME实验名称（必填）
选项说明
--json打印 JSON

train export

把训练好的模型及其索引导出到音色库。

rvc-next train export [OPTIONS] NAME
参数说明
NAME实验名称（必填）
选项说明默认值
--checkpoint <str>小模型或 G 检查点的名称最新的一个
--epoch <int>导出这一轮的小模型或检查点—
--voice-name <str>音色库中的音色名称—

train import

把一个原版 RVC 实验文件夹复制进来；输出已存在的阶段算作已完成。

rvc-next train import [OPTIONS] PATH
参数说明
PATH一个原版实验文件夹（logs/<名称>，必填）
选项说明
--name <str>新名称
rvc-next train import D:/RVC/logs/alice --name alice-old

实时变声：live

使用服务器所在电脑的音频设备进行实时转换。

live devices

列出服务器的音频设备：每个物理设备一行，以及它的各个驱动（host API）和 id，标出默认设备、虚拟设备和推荐的驱动。

选项说明默认值
--refresh重新枚举设备True（始终重新枚举）
--json打印 JSON关

live check

检查已保存的设备：解析结果、格式、拓扑（单个双工流或分离的输入输出流）和估计延迟。检查不通过时退出码为 8。

选项说明
--json打印 JSON

live latency

用回环实测已保存设备的真实延迟：先把输出接回输入（音频线、虚拟声卡的回环，或把扬声器靠近麦克风）。在输出播放四段噪声，在输入中找到它们，打印实测的往返时间、转换器自身的延迟、两者之和，以及供对比的估计值。实时变声必须已停止。没有检测到返回的噪声或各段结果不一致时退出码为 1，设备无法打开时为 8。

rvc-next live latency [OPTIONS]
选项说明默认值
--block-ms块长（毫秒）已保存的值
--level-db测试噪声的峰值电平，−40 到 −3 dBFS-12
--json打印 JSON关

live test-tone

在一个输出设备上播放一小段提示音。

rvc-next live test-tone [OPTIONS] [DEVICE]
参数说明默认值
DEVICE输出设备 id、名称或 defaultdefault

live run

用服务器的设备实时转换，直到按 ctrl+c，终端显示一行状态。

选项说明默认值
-v, --voice <str>音色 id 或名称上次使用的音色
--input <str>输入设备 id、名称或 default已保存的设备
--output <str>输出设备 id、名称或 default已保存的设备
--monitor <str>监听输出 id、名称、default 或 none已保存的设置
--preset <str>以这个预设为起点同一音色时为上次的参数，否则为音色的默认预设
--speaker <int>多说话人音色的说话人 id，[0, 109]取自起点参数
--pitch <float>音高偏移（半音），[-24, 24]取自起点参数
--formant <float>共振峰偏移（半音），[-2, 2]取自起点参数
--f0 <str>音高算法：pm、rmvpe、fcpe、crepe、crepe-tiny 或 swift取自起点参数
--index-rate <float>索引强度，[0, 1]取自起点参数
--protect <float>辅音保护，[0, 0.5]；0.5 为关闭取自起点参数
--rms-mix <float>响度匹配，[0, 1]；1 保持转换后的响度取自起点参数
--unvoiced <mode>无音高帧：protect、zero 或 original，见无音高帧取自起点参数
--autotune <float>把音拉向最近的半音，[0, 1]；0 为关闭取自起点参数
--block-ms <int>块长（毫秒），[20, 1500]已保存的值（250）
--crossfade-ms <int>交叉淡化（毫秒），[10, 150]已保存的值（50）
--context-ms <int>额外上下文（毫秒），[50, 5000]已保存的值（2500）
--threshold-db <float>输入门限（dB），[-60, 0]；-60 为关闭已保存的值（-60）
--denoise-strength <float>降噪强度，[0, 1]已保存的值（0.9）
--phase-vocoder / --no-phase-vocoder块之间用相位声码器交叉淡化已保存的值（关）
--effect <spec>转换结果上的效果，写法同 convert --effect；替换已保存的效果链，none 清空已保存的效果链
--input-gain <float>输入音量（dB），[-24, 24]已保存的值（0）
--record <source>运行后把会话录到输出文件夹：both（立体声，左为输入）、converted 或 input；实时变声停止时打印文件路径不录音
--allow-fallback已保存的输出设备不存在、将使用默认设备时仍然启动关
--seconds <float>运行这么多秒后停止直到 ctrl+c

设备名可以写完整名称或其中一部分，只要只匹配到一个设备；匹配到多个时请改用 live devices 中的 id。启动后，所用的设备、缓冲参数、音色和参数会保存为下次的默认值。

rvc-next live run -v "我的音色" --pitch 12 --block-ms 400
rvc-next live run --input "USB Microphone" --output "CABLE Input" --monitor none

任务：jobs

本机的任务，包括正在运行的服务器的任务。

jobs list

按时间倒序列出任务。

选项说明默认值
--state <str>一个状态（queued、waiting、running、cancelling、cancelled、failed、completed、interrupted），或 active、finished全部
--limit <int>最多列出多少个，[1, 200]30
--json打印 JSON关

jobs show

显示一个任务，可选打印其日志。

rvc-next jobs show [OPTIONS] JOB_ID
参数说明
JOB_ID任务 id（必填）
选项说明
--log打印任务日志
--json打印 JSON
rvc-next jobs list --state failed
rvc-next jobs show j18f3c2a9b1c4d5e6f --log   # 任务 id 来自 jobs list

概览

上一页

配置与环境变量

rvc-next 的设置保存在数据目录的 settings.toml 里，Web UI 的 设置 页、rvc-next config 命令和环境变量改的是同一份设置。本页列出全部设置项、环境变量和数据目录的结构。

本页目录

根命令服务器与系统webuiversionenvdoctor转换与分离convertanalyseeffectsseparate文字转语音：ttstts voicestts speak设置：configconfig showconfig getconfig setconfig path资源：assetsassets listassets downloadassets verify模型：modelmodel listmodel infomodel importmodel catalogmodel downloadmodel editmodel exportmodel removemodel mergemodel extractmodel indexmodel index attachmodel index assignmodel index build预设：presetpreset listpreset savepreset remove训练：traintrain listtrain newtrain datasettrain dataset scantrain dataset speakerstrain runtrain statustrain exporttrain import实时变声：livelive deviceslive checklive latencylive test-tonelive run任务：jobsjobs listjobs show