メニュー
Style-Bert-VITS2のモデル・speaker・style選択とFastAPIの分離tmux起動・稼働確認
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/NEXTAltair/style-bert-vits2-bridge --skill voiceコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
| name | voice |
| description | Style-Bert-VITS2のモデル・speaker・style選択とFastAPIの分離tmux起動・稼働確認 |
このスキルは、Style-Bert-VITS2 (SBV2) で音声を生成する際のモデル・スピーカー・スタイル選択をガイドします。
TTS実行前にhttp://127.0.0.1:5000/statusを確認します。応答しない場合は、OpenClaw/Gatewayの実行ターミナルを占有するforeground processや、その子として残すnohup / setsidではなく、専用のdetached tmux session sbv2-fastapiで起動します。通常運用ではsystemd service登録は不要です。
curl --fail --silent --show-error --max-time 2 http://127.0.0.1:5000/status
疎通しない場合は既存sessionを確認します。
tmux has-session -t sbv2-fastapi 2>/dev/null
tmux capture-pane -t sbv2-fastapi -p -S - | tail -80
sessionが存在する場合は重複起動しません。OpenClaw/Gateway内から通常のdetached tmuxを起動すると、Gateway serviceのKillMode=control-groupによりGateway再起動時にtmuxも終了します。OpenClawから起動する場合は、永続service fileを登録せず、transient user unit内へtmux serverを分離します。
systemctl --user reset-failed sbv2-fastapi-tmux.service 2>/dev/null || true
systemd-run --user \
--unit=sbv2-fastapi-tmux \
--collect \
--property=Type=exec \
--property=Restart=no \
/bin/bash -lc 'set -e; /usr/bin/tmux new-session -d -s sbv2-fastapi -c /home/altair/src/Style-Bert-VITS2 "exec /home/altair/.local/bin/uv run server_fastapi.py"; /usr/bin/tmux set-option -t sbv2-fastapi remain-on-exit on; sbv2_tmux_pid=$(/usr/bin/tmux display-message -p -t sbv2-fastapi "#{pid}"); exec /usr/bin/tail --pid="$sbv2_tmux_pid" -f /dev/null'
これは一時unitであり、unit fileや自動起動設定は作りません。Gatewayとは別cgroupで動き、tmuxが終了するとunitも回収されます。外部の人間用terminalから起動する場合は通常のdetached tmuxでも構いません。
/mnt/h上のmodel catalog読み込みは数分かかることがあります。起動後は最大300秒待って/statusと/models/infoを確認します。
for _ in $(seq 1 150); do
if curl --fail --silent --max-time 2 http://127.0.0.1:5000/status; then
break
fi
sleep 2
done
curl --fail --silent --show-error --max-time 5 http://127.0.0.1:5000/models/info
最後まで失敗する場合は、別のTTS providerへ声を切り替えず、tmux list-panes -t sbv2-fastapi -F '#{pane_pid} #{pane_dead} #{pane_dead_status} #{pane_current_command}'とtmux capture-pane -t sbv2-fastapi -p -S - | tail -120で終了statusとログを確認し、SBV2 unavailableとして扱います。
OpenClaw 2026.7.2以降では、SBV2専用personaへfallbackPolicy: "fail"を設定して後続providerへのfallbackを禁止できます。自動TTSをfail-closedにする場合は、tts.personaまたは/tts persona <id>のsession preferenceがSBV2専用personaを指し、そのpersonaがstyle-bert-vits2だけをproviderとして持つことを確認します。現在のValentina設定ではtts.personas.valentina.fallbackPolicyをfailにします。
基本ルール: model / speaker は声の同一性を決め、style は選択済みモデル内の表情・トーンを決めます。別の声にしたい場合は model / speaker を選び直し、現在の声の表現だけを変えたい場合に style を選びます。
SBV2 は model_assets/ 内のディレクトリ名でモデルを指定します。/models/info でロード済みモデル一覧を取得できます。
model_name: ディレクトリ名で指定（model_id より優先）model_id: 数値で指定（デフォルト 0）モデルは声質・学習済み話者の土台です。「どの声を使うか」を決めるときは style ではなく model を選びます。
複数話者モデルでは、esd.list の登場順で speaker_id が決まります（0始まり）。
speaker_name: 話者名で指定（speaker_id より優先）speaker_id: 数値で指定（デフォルト 0）スピーカーは同じモデル内の話者を決めます。単一話者モデルでは model name と speaker name が同じになることがあります。
スタイルはモデルごとに異なります。SBV2 に渡してよい style 名は、ロード済みモデルの /models/info に出る style2id のキーだけです。
style: スタイル名（デフォルト "Neutral"）style_weight: スタイルの強さ（デフォルト 1.0）
スタイルは「どの声が良いか」を決める項目ではありません。選択済みの model / speaker を保ったまま、明るい、落ち着いた、注意喚起などの表情を切り替える項目です。
style_weight は音声生成時に既存 style をどの強さで使うかの値です。models merge-* の --speech-style-weight や --style-recipe による style vector の混合比とは別物です。感情 style の効きが弱い時は、まず生成時 style_weight と sample 音声を確認し、モデルマージ比率を変えて作り直す判断はその後に行います。
SBV2 の style は style_vectors.npy の行と config.json の data.style2id の対応で決まります。カスタムモデルでは、raw 音声を Data/<model>/raw/<style名>/*.wav のように分類してから style vector を生成します。
raw 直下に WAV だけがあるモデルは、基本的に Neutral だけになります。style サブフォルダが 2 個以上ある場合は、Neutral と各サブフォルダ名が style として生成されます。
clear、soft、bright、alert などはエージェント内の tone 分類です。style2id に同名の style が存在しない限り、SBV2 に渡す style 名ではありません。length、sdp_ratio、noise、assist_text などで作った比較音声も、学習済み style とは別物として扱います。
length: 話速の倍率（デフォルト 1.0）。値が大きいほどゆっくり、小さいほど速くなります。別のテキストの感情・声色を混合して音声に反映できます。抑揚やテンポが犠牲になる傾向があります。
assist_text: 感情の参考にするテキストassist_text_weight: 補助テキストの影響度（デフォルト 1.0）assist_text は常用しません。短い文脈だけでは意図した tone が出ない場合に、短い補助文を一時的に足します。説明文のような長い補助テキストや、本文と矛盾する感情は避けてください。
pronunciationReplacements / pronunciationReplacementsPath は、自然な会話文として読み上げたい語の読みを補正するための辞書です。辞書は「読ませたい言葉の読みを直す」ために使い、そもそも TTS に投げるべきではない text を読める形にする逃げ道として使いません。
辞書に追加してよいもの:
Style-Bert-VITS2, OpenClawSBV2, ValentinaAPI, TTS辞書で処理しないもの:
Issue: https://... のような GitHub issue / PR status 行これらは読み置換ではなく、TTS に投げる前の eligibility、filter、要約、skip、または tool/status text preparation 側で扱います。たとえば Issue: https://... を辞書で救おうとせず、必要なら「Issue を確認しました」のような自然文に変換するか、読み上げ対象から外してください。
読み間違いを見つけた時の triage:
/voice の text hard limit を超えないことを確認する。Valentina 系モデルの style は SBV2 共通の emotion taxonomy ではなく、モデルごとの style2id に定義された style 名です。/docs は API 仕様確認用であり、ロード済みモデル情報は /models/info で確認できます。
Valentina などの style 対応モデルでは、まず現在使う model_name と speaker_name を声の同一性として固定します。その後、現在の感情、文脈、応答温度に合わせて style2id 内の style を動的に選びます。
clear、soft、serious、alert などの tone は、エージェントが文脈に応じて style を選ぶための分類名です。該当する実 style が無いモデルでは Neutral を使い、必要なら推論パラメータで控えめに調整します。
/models/info の style2id に含まれる style 名だけを /voice に渡す。style2id を見て判断する。clear: 明るく聞き取りやすい説明soft: 柔らかい応答、落ち着いた相槌serious: 注意、事務的な確認、低めの温度感alert: 短い警告、割り込み、重要通知style_weight はエージェントまたは呼び出し側が文脈に応じて決める。スキル内で tone ごとの固定値を持たない。assist_text は style だけで足りない場合にだけ使う。/models/info でロード済みモデルとスピーカーを確認するstyle2id に存在する style だけを候補にするstyle_weight はエージェントまたは呼び出し側が文脈に応じて決める音声素材の ingest、dataset prepare、training、evaluation、model promotion、model merge は TTS 再生よりも影響が大きい制作系操作です。長時間処理や GPU/CPU 高負荷処理を開始する前に、入力、出力名、保存先、stage、既存出力に上書きしないことをユーザーへ確認してください。
agent はユーザー確認なしに、既存 model/dataset/checkpoint/job artifact の上書きや削除、生成モデルや音声 artifact の公開、共有、外部 upload、外部送信を行いません。
失敗時は README の制作機能安全運用に従い、jobs status、jobs log、summary.json、入力 manifest、SBV2 Data/ と model_assets/、GPU/依存関係の順で切り分けます。