サポート・既知の問題

対応範囲、既知の問題、基本的な確認方法を掲載しています。正常に読み上げられない場合は、「基本的な確認」を上から順番に確認してください。

1. サポート対象

記載された環境での基本的な導入と動作確認を対象とします。すべてのPC構成、音声モデル、Discordサーバー設定で同一の動作を保証するものではありません。

Linux環境での動作確認実績はありますが、本サイトではWindows 11向けの手順のみを案内しています。Linux環境の導入、設定、起動方法はサポート対象外です。

AivisSpeech Engineが起動していることを確認してください。停止している場合は音声を生成できません。

ffmpeg -version

バージョン情報が表示されない場合は、FFmpegの導入またはPATHの反映を確認してください。

Bot本体と同じフォルダにあり、Discord Botトークン本体だけが1行で保存されていることを確認してください。

通常は状態確認コマンドを実行する必要はありません。読み上げが始まらない場合は最初に/statusを実行し、さらに詳しい情報が必要な場合だけ/status_detailを使用します。

文字数上限を大きくすると、文章や音声モデルによって、読み上げが極端に早くなったり、発音やイントネーションが不自然になったりする場合があります。Bot側だけでは完全に防げない場合があるため、文字数上限は100～200文字を推奨します。

ひらがなの「すらっしゅ」を含む文章などで、AivisSpeech Engineが音声生成に失敗する場合があります。この場合は「スラッシュ」など別の表記へ変更してください。

AivisSpeech Engineの音声クエリ生成段階でエラーになるため、Bot側の文字分割や再試行だけでは解決できない場合があります。

記号や絵文字は安全に音声生成するため、読み上げ用の言葉への変換または省略を行います。記号だけ、または音声生成に適さない文字だけの投稿はスキップする場合があります。

このBotは1つのDiscordサーバーでの利用を前提としています。複数のDiscordサーバーへ同じBotを導入した場合、設定や読み上げ状態が意図しない動作になる可能性があります。

AivisSpeechへ多数の話者やモデルを追加している場合、Discordの選択画面には先頭25件まで表示されます。これはDiscordの選択UIによる制限です。

読み上げ速度、発音、イントネーション、記号の反映方法は、使用する音声モデルやスタイルによって異なります。

問題について問い合わせる場合は、次の情報を添えてください。

問い合わせ用テンプレートの例

使用版：α6
OS：Windows 11
Python：3.13.12
発生した操作：/connect後、読み上げチャンネルへ文章を投稿
発生した問題：音声が生成されず、次の文章へ進んだ
再現性：同じ文章で毎回発生

contact☆twilight-relay.com（☆を@に置き換えてください）

security☆twilight-relay.com（☆を@に置き換えてください）

token.txt、Botトークン、トークンが表示されたPowerShell画面、トークンを含む設定ファイルを、Webサイト、チャット、スクリーンショット、公開リポジトリへ掲載しないでください。

Botトークンが外部へ漏れた可能性がある場合は、Discord Developer Portalでトークンを再生成し、token.txtを新しいトークンへ更新してください。