synthesize

音声を合成する

Kokoro TTS CLI ツールを使用して、テキストから音声を生成します。単一の WAV 出力、または長文向けのチャンク分割ストリーミングに対応しています。

自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある場合、パラメーターにずれが生じた場合、または回避策が必要になった場合は、先送りせずにこのファイルをすぐに修正してください。実際に再現できる問題がある場合にのみ更新してください。

すぐに使う

# Single WAV
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py \
  --text "Hello from Kokoro TTS" --voice af_heart --lang en-us --speed 1.0 \
  --output /tmp/kokoro-tts-$$.wav

# Play it
afplay /tmp/kokoro-tts-$$.wav

パラメーター

パラメーター	デフォルト	説明
--text	（必須）	合成するテキスト
--voice	af_heart	音声名（音声カタログを参照）
--lang	en-us	言語コード（en-us、zh、ja など）
--speed	1.0	音声速度の倍率
--output	（必須）	出力する WAV のパス
--chunk	オフ	長文向けのチャンク分割ストリーミングモード

音声カタログ

品質評価を含む利用可能な音声の一覧については、音声カタログを参照してください。

おすすめの音声：

音声 ID	名前	評価	性別
af_heart	Heart	A	女性
af_bella	Bella	A-	女性
af_nicole	Nicole	B-	女性

チャンク分割ストリーミング

長文の場合は、--chunk を使用すると、順次再生できます。

~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py \
  --text "Long text here..." --voice af_heart --lang en-us --speed 1.0 \
  --output /tmp/kokoro-tts-$$.wav --chunk

各チャンクの WAV パスは、準備ができ次第 stdout に出力されます。最後の行は DONE <ms> です。

トラブルシューティング

問題	原因	解決策
音声が出力されない	モデルが読み込まれていない	まず /kokoro-tts:install を実行してください
テキストが空というエラー	入力が空白だった	空ではない --text を指定してください
生成が遅い	初回実行時のウォームアップ	正常です。2回目以降の実行は速くなります

実行後の振り返り

このスキルの実行後、終了する前に次の点を確認してください。

1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった手順またはエラーテーブルを修正してください。
2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースにずれが生じている場合は、使用例とパラメーターテーブルを実態に合わせて更新してください。
3. 回避策が必要でしたか？ — 臨機応変な対応（異なるフラグ、追加手順）が必要だった場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。

問題が実際に再現できる場合にのみ更新してください。推測で更新しないでください。