Fish Audio Docs
統合ガイドサードパーティの統合
Back to site

Tavo セットアップ ガイド

Tavo で Fish Audio をカスタム OpenAI 互換の TTS プロバイダーとして構成し、キャラクターに Fish Audio 音声を割り当てます。

Fish Audio TTS を Tavo に接続します

このガイドでは、Tavo で Fish Audio をカスタム OpenAI 互換の TTS プロバイダーとして設定し、キャラクターに Fish Audio 音声を割り当てる方法を示します。セットアップ後、Tavo は選択した音声で文字メッセージを読み上げることができます。

必要なもの

  1. API クレジットを持つ Fish Audio アカウント。
  2. Fish Audio API キー;
  3. 使用する Fish Audio 音声 ID。
  4. 動作する Tavo インストール。

API キーは機密の資格情報です。他の人に送信したり、チャット メッセージ、公開スクリーンショット、または信頼できない Web サイトに含めたりしないでください。 Tavo の専用キーを作成して、個別に監視または取り消しできるようにします。

ステップ 1: Fish Audio API キーを作成する

Fish Audio にサインインし、API 管理を開き、Tavo のキーを作成します。完全なキーは 1 回しか表示されないため、すぐにコピーして保存します。

ステップ 2: 音声 ID を見つける

Tavo が特定の音声で音声を合成するには、Voice ID が必要です。 Fish Audio 音声リストから 1 つをコピーするか、API をクエリします。

接続をすぐにテストするには、次のパブリック システム音声 ID から開始します。

00a1b221-6137-4b73-ad62-b0cbce134167

これを最初の接続テストに使用し、Tavo がオーディオを正常に生成して再生できるようになったら、好みの音声 ID に置き換えます。

GET /api/open/v1/voices
Authorization: Bearer YOUR_API_KEY

モデルと音声フィールドを混同しないでください。モデルは TTS エンジンを選択し、音声 ID はスピーカーのサウンドを選択します。

ステップ 3: Tavo に音声 API を追加する

Tavo で、以下を開きます。

More → Voice & Image Generation → Voice API → New

TTS カスタム OpenAI プロトコル モデル を選択し、次のように入力します。

タボ設定
API ベース URLhttps://fishaudio.org/v1
API キーFish Audio API キー
モデルIDfishaudio-s21pro-flash
音声ID00a1b221-6137-4b73-ad62-b0cbce134167 (テスト後に交換)
音声フォーマットmp3

ベース URL は /v1 で終わる必要があります。 /audio/speech を追加しないでください。 Tavo は、リクエストを送信するときに完全な /v1/audio/speech パスを追加します。

プロバイダーを保存します。 Tavo が接続テストを提供する場合は、短い文を 1 つ生成し、音声が再生されることを確認します。

ステップ 4: キャラクターに音声を割り当てる

音声 API を作成した後、Tavo のキャラクター ボイス バインディング画面を開きます。

Character Voice Binding → Select Character → Select Your Voice API

Tavo が音声 ID を要求した場合は、同じ Fish Audio 音声 ID を再度入力します。バインドを保存し、チャットに戻り、短いメッセージを送信し、音声再生を開始します。

各キャラクターに異なる Fish Audio ボイスを割り当てることができます。プロバイダ設定を再利用し、各文字バインディングの音声 ID のみを変更します。

API クレジットの使用量

Tavo は、Fish Audio /v1/audio/speech を通じて音声を生成し、別の API クレジット残高を消費します。テキスト読み上げは有効文字あたり 1 API クレジットから始まり、一部のモデルでは乗数が適用される場合があります。

API 価格設定 からクレジットを購入し、API 管理で残高を確認してください。実際のリクエストコストは X-OpenAPI-Credits-Used で返されます。

トラブルシューティングと FAQ

Tavo が接続障害を報告しました

ベース URL が https://fishaudio.org/v1 であることを確認し、API キーから空白を削除し、アカウントに API クレジットが残っていることを確認します。 Fish Audio アカウントのパスワードは入力しないでください。

リクエストは 401 を返すか、API キーが無効であると言います

Fish Audio API キーを再度コピーします。取り消された場合は、新しいキーを作成し、Tavo に保存されている古い資格情報を置き換えます。

リクエストが 402 を返すか、残高が不十分であると表示されます

API クレジット残高が少なすぎます。メンバーシップ クレジットと API クレジットは別の残高であるため、API 価格ページ から API クレジットを購入してください。

Tavo は接続しますが、オーディオが再生されません

キャラクターがボイス API にバインドされていること、およびボイス ID が有効であることを確認してください。まず mp3 で短い文をテストし、次に Tavo の自動再生、ミュート、およびバックグラウンド再生の設定を確認します。

タボはモデルまたは音声が無効だと言いました

モデル ID として fishaudio-s21pro-flash を使用し、音声として Fish Audio 音声 ID を使用します。 tts-1alloy などの OpenAI 名は、Fish Audio モデルまたは音声に自動的にマッピングされません。

各キャラクターは異なる声を使用できますか?

はい。各キャラクターに一致する Fish Audio 音声 ID を入力して、キャラクターに異なる音声を与えます。

関連ドキュメント