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

RikkaHub セットアップガイド

RikkaHub の Fish Audio プロバイダーを互換 /v1/tts エンドポイントに向け、Voice ID とモデルを設定します。

Fish Audio TTS を RikkaHub に接続する

RikkaHub で Fish Audio 音声プロバイダーを選び、API ベースを api.fish.audio ではなく Fish Audio に向けてください。そのうえで API キー、Voice ID、モデルを /v1/tts 向けに設定します。

セットアップ後、RikkaHub 音声リクエストは Fish Audio API クレジット残高を消費し、選択した音声 ID を通じて音声を再生します。

必要なもの

  1. API クレジットを持つ Fish Audio アカウント。
  2. Fish Audio API キー。
  3. Fish Audio 音声 ID (reference_id);
  4. RikkaHub (Fish Audio 音声プロバイダーが利用可能)。

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

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

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

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

RikkaHub は音声 ID を reference_id として送信します。 Fish Audio 音声リストから 1 つをコピーするか、API をクエリします。

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

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

00a1b221-6137-4b73-ad62-b0cbce134167

RikkaHub がオーディオを正常に生成して再生できるようになったら、これを好みの音声 ID に置き換えます。

モデルと音声を混同しないでください。

ステップ 3: RikkaHub で Fish Audio プロバイダーを構成する

RikkaHub で、Fish Audio / TTS プロバイダー設定を開き、次のように入力します。

RikkaHub設定
API ベース/エンドポイント ホストhttps://fishaudio.org
完全なエンドポイント (必要な場合)https://fishaudio.org/v1/tts
APIキーFish Audio API キー
モデルs2.1-pro または s2.1-pro-flash
音声 / reference_id00a1b221-6137-4b73-ad62-b0cbce134167 (テスト後に交換)
フォーマットmp3

RikkaHub ビルドに表示されるフィールド名を使用します。重要な部分は、リクエストが次のように POST https://fishaudio.org/v1/tts に到達することです。

Authorization: Bearer YOUR_API_KEY
model: s2.1-pro
Content-Type: application/json

text と空ではない reference_id を含む JSON ボディ。

RikkaHub が https://api.fish.audio に事前入力されている場合は、ホストを https://fishaudio.org に置き換え、/v1/tts を保持します。

プロバイダーを保存し、短い文を 1 つ生成し、返された音声を RikkaHub が再生できることを確認します。

ステップ 4: 必要な場所に音声を割り当てる

RikkaHub でキャラクター、チャット、またはアシスタントごとに音声を選択できる場合は、同じ Fish Audio 音声 ID をそのフィールドに貼り付けます。 1 つのプロバイダー構成を再利用し、文字ごとに reference_id のみを変更できます。

API クレジットの使用量

RikkaHub は Fish Audio /v1/tts を呼び出し、別の API クレジット残高を消費します。テキスト読み上げは、有効文字あたり 1 API クレジットから始まり、一部のモデルでは乗数が適用される場合があります。

API 価格設定 からクレジットを購入し、API 管理で残高を確認してください。成功した応答には、X-OpenAPI-Credits-Used が含まれる場合があります。

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

RikkaHub が接続障害を報告します

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

リクエストは 400 を返し、reference_id について言及します

Fish Audio には明示的な音声 ID が必要です。有効な reference_id を入力してください。サーバーは黙ってデフォルトの音声を選択しません。

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

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

リクエストは 402 を返すか、残高が不十分であることを示します

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

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

最初に mp3 でテストします。クライアントが opus をリクエストした場合、Fish Audio は mp3 にフォールバックするため、一般的な Android プレーヤーは応答をデコードできます。また、音声 ID が有効であること、RikkaHub の自動再生またはミュート設定が再生をブロックしていないことも確認してください。

どのモデルを選択すればよいですか?

s2.1-pro または s2.1-pro-flash から始めます。 Fish Audio は、これらのfish.audio ラベルを一致するエンジン モデル ID にマップします。 fishaudio-s21pro-flash などのネイティブ ID は、model ヘッダーでも機能します。

関連ドキュメント