VOICEVOXは無料で使える中品質なテキスト読み上げ・歌声合成ソフトウェアです。オープンソースのサーバを立ち上げ、API経由で音声ファイルを作成することも可能です。
今回は、Dockerでサーバを立ち上げ、テスト音声を出力するまでをまとめてみました。
Dockerでの立ち上げ
docker run -it -p 50021:50021 voicevox/voicevox_engine:cpu-latest
常駐させて API サーバとして使う場合は、それなら -it ではなく -d --restart unless-stopped にした方が安定します（後述）。
各オプションの意味
docker run
新しいコンテナを起動する基本コマンドです。イメージを指定すると、それを元にコンテナが作られます。
-i（interactive）：標準入力を有効化。
-t（tty）：仮想端末を割り当て。
→ 合わせて「対話モードで起動する」という意味。
ただし VOICEVOX のようにサーバ常駐させる用途では不要なので、通常は -d（デタッチ：バックグラウンド実行）がよく使われます。
例：
docker run -d -p 50021:50021 voicevox/voicevox_engine:cpu-latest
-p 50021:50021
ホストOS（Windows/WSL側）のポート 50021 を、コンテナ内のポート 50021 に公開（ポートフォワード）します。
→ これにより http://localhost:50021 で API にアクセス可能となります。
voicevox/voicevox_engine:cpu-latest
実行する Docker イメージの名前です。
voicevox/voicevox_engine … VOICEVOX ENGINE の公式 Docker イメージ
:cpu-latest … CPU 版の最新版を指定（GPU 版なら :gpu-latest）
補足（よく使うバリエーション）
バックグラウンドで動かしたい
docker run -d --name voicevox -p 50021:50021 voicevox/voicevox_engine:cpu-latest
自動再起動をつけたい（PC再起動後も起動）
docker run -d --name voicevox -p 50021:50021 --restart unless-stopped voicevox/voicevox_engine:cpu-latest
ログを確認したい
docker logs -f voicevox
音声出力テスト
ブラウザで「http://localhost:50021/docs」を起動。
（ブラウザは右上のプロフィールアイコン →「ゲストモードを開く」で開いています）
テストでwavを作成してみます。1行目でBody用JSONを作成して、2行目でそれを使って音声ファイルを出力しています。
$ curl -s -X POST "http://localhost:50021/audio_query?speaker=1&text=$(php -r 'echo urlencode("おはようございます");')" -H "Content-Type: application/x-www-form-urlencoded" -d "" -o query.json
$ curl -s -X POST "http://localhost:50021/synthesis?speaker=1" -H "Content-Type: application/json" -d @query.json -o out.wav
out.wavを再生すると「おはようございます」とwavができているはずです。
speakerを変えると、声が変わります。http://localhost:50021/speakers で表示されるJSONの、styles以下にあるidがspeakerのIDです。スピーカーごとのサンプルボイスは下記のURLにあります。
speakerを変えるときは、1行目、2行目両方のspeaker=Xを変更してください。どちらかのみ変更すると正しく声が変わりません。
メモ
Dockerコンテナの停止、削除方法
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e0168b5ae8fd voicevox/voicevox_engine:cpu-latest "/entrypoint.sh gosu…" 5 minutes ago Up 5 minutes 0.0.0.0:50021->50021/tcp laughing_goldstine
ogawa-ha@Vostro143420:~/docker$ docker stop laughing_goldstine
docker stop laughing_goldstine
1. コンテナを停止する（再利用する場合）
docker stop laughing_goldstine
→ 状態が停止（Exited）になります。
再度動かしたいときは：
docker start laughing_goldstine
2. コンテナを削除する（不要なら消す）
docker rm -f laughing_goldstine
→ 完全に削除されます。
もう一度起動する場合は新しく docker run ... してください。
確認
docker ps
で一覧に出なくなれば止められています。