COEIROINK
💡ネットワーク接続エラー(NetworkConnectionError){#network}。
原因
- COEIROINKローカルサーバー(通常
127.0.0.0.1:50032)が実行中でないか、
ファイアウォールまたはアンチウイルスプログラムによってポートへのアクセスがブロックされている。
- PCがオフライン状態か、ローカルループバック通信が無効になっている。
解決方法
- COEIROINKエンジンが実行中であることを確認してください。
- COEIROINK GUIまたはCLIサーバーが開いている必要があります。
- 127.0.0.0.0.1:50032`ポートが開いているか確認してください。
- ファイアウォール/セキュリティプログラムの例外登録。
coeiroink.exe または voicevox_engine.exe がブロックされないように例外処理します。
- エンジンの再起動
- COEIROINKを終了後、再起動すると、ポートが新たに初期化されます。
- インターネット接続の確認(必要な場合)
- 一部の外部リソースを呼び出す場合、ネットワーク接続が必要な場合があります。
💡 COEIROINKサーバー接続に失敗しました(CoeiroinkServerConnectionError) {#coeiroink-server}。
原因
- ローカルCOEIROINKサーバーがオフになっているか、APIポート(
50032)が変更された。
- 複数のアプリケーションが同時に同じポートを使用している。
解決方法
- COEIROINKを実行後、"APIサーバーを有効にする""**オプションをオンにします。
GUIではなく、CLIモードで実行していることを確認してください。
- Windowsのコマンドプロンプトで以下を入力:
netstat -ano | find "50032"
→ ポートが"LISTENING"状態でなければ、COEIROINKが実行されていないことになります。
- ポートが競合する場合、他のポートを指定して実行後、設定ファイルで変更します。
設定ファイルで該当ポートに変更します。
💡 サーバー応答解釈エラー (CoeiroinkJsonParseError) {#coeiroink-json} {#coeiroink-json
原因
- COEIROINKサーバーが異常なJSONデータを返す。
- エンジンのバージョンが異なるか、応答フォーマットが変更された。
- リクエストの途中で強制終了し、JSONが完全でない。
解決方法
- COEIROINKのバージョン確認
- VoiceScriptPlayerが使用するAPIバージョンと互換性のあるバージョンであることを確認します。
- 古いバージョンであれば、最新のCOEIROINKエンジンにアップデートしてください。
- 文章の簡略化
- 長すぎる文章や特殊文字を含む文章は、JSON変換中に問題が発生する可能性があります。
- ログファイルの確認
- COEIROINKコンソールまたはログで"predict_with_duration"エラーメッセージを確認してください。
💡Prosodyデータを取得できませんでした(CoeiroinkProsodyEmpty) {#coeiroink-text}。
原因
- 入力文が短すぎるか、サポートされていない文字の組み合わせが含まれている。
- PredictProsodyDetail()`の呼び出しが失敗しましたが、例外が検出されませんでした。
解決方法
- 入力文を短く分割してテスト
- 非正常文字を削除して再試行します
- 特殊記号、制御文字、絵文字を削除して再試行します。
- エンジンログの確認
- "predict_with_duration"リクエスト時に応答が空白の場合、エンジンが一部の文字を処理できなかった可能性があります。
💡Prosody予測失敗 (CoerioinkPredictError) {#coeiroink-prosody} {#coeiroink-prosody}
原因
- prosody予測要求(
/v1/predict_with_duration)が失敗しました。
- APIレスポンスコードが400、404、500などとして返される。
解決方法
- COEIROINKサーバーログの確認
- "predict_with_duration"段階でどのようなエラーが発生したかを確認します。
- 入力テキストの簡略化
- 長い文章、絵文字、日本語以外の文字を削除してテストします。
- 速度調整の確認
speedScaleの値が0以下または大きすぎると処理に失敗する可能性があります。
💡 オーディオ処理失敗 (CoerioinkProcessError) {#coeiroink-process} {#coeiroink-process}
原因
v1/processリクエストで音声生成中にエラーが発生。
- prosody 予測段階で生成された
wavBase64 データが破損している。
解決方法
- 生成を再試行する
- 同じ文章を再試行すると、一時的なキャッシュの問題である可能性があります。
- エンジンログの確認
- "process"段階でエラーコードが出力されたか確認します。
- pitchScale、intonationScaleの値を確認します
- 高すぎる値(例えば、5.0以上)は内部計算エラーを引き起こす可能性があります。
💡生成されたオーディオデータが空である(CoeioinkEmptyAudio) {#coeiroink-empty}。
原因
- エンジンが音声を出力できず、空の応答を返す。
- 一部の文に発音可能なモーラがない(例えば、記号だけが含まれる文)。
解決方法
- 文章を再確認する
- "...", "♪", "♡" など発音できない文字は削除します。
- エンジンを再起動する
- COEIROINKを再起動すると、一時キャッシュが初期化されます。
- 別の話者/スタイルで試す
- 特定の音声スタイルでエラーが発生する場合があります。
原因
- エンジンがWAVの代わりにエラーメッセージをテキストで返す。
- WAVヘッダーが破損しているか、データが途中で切れている。
解決方法
- 出力ファイルを確認する*
- 実際に返されたファイルがWAVヘッダー("RIFF")で始まることを確認します。
- COEIROINKのアップデート
- 古いバージョンのエンジンでは、一部の設定値を処理できない場合があります。
- 短い文章でテストしてください
- 過度に長いテキストを入力すると、エンジン内部のバッファオーバーを引き起こす可能性があります。
💡不明なCOEIROINKエラー(CoeiroinkUnknownError) {#coeiroink-general}。
原因
- 処理中の予期せぬ例外発生(ファイルアクセス、メモリ不足など)。
- VoiceScriptPlayerとCOEIROINK間のプロトコル不一致。
解決方法
- VoiceScriptPlayerとCOEIROINKのバージョンを確認してください
- プロジェクトを再起動してください
- 一時的なキャッシュとセッションデータが壊れている可能性があります。
- 開発者にお問い合わせください
- ログファイル(
vsp_log.txtなど)を添付して、issue trackerまたはPatreonに報告してください。