Tavo およびその他の OpenAI 互換音声クライアントを Fish Audio TTS に接続します。

OpenAI 互換 TTS

クライアントが OpenAI POST /v1/audio/speech コントラクトを予期する場合は、このエンドポイントを使用します。これは、Tavo の カスタム OpenAI プロトコル TTS プロバイダーなどの統合を目的としています。

完全なリクエストコントラクトとのネイティブ Fish Audio 統合の場合は、Sync HTTP を使用します。

＃＃終点

POST /v1/audio/speech
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

完全な URL:

https://fishaudio.org/v1/audio/speech

API キーを信頼できるサーバー上、またはサードパーティプロバイダーの保護された API 資格情報フィールドに保存します。顧客または統合ごとに個別のキーを作成して、個別に監視および取り消しできるようにします。

＃＃リクエスト

{
  "model": "fishaudio-s21pro-flash",
  "input": "Hello from Fish Audio.",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}

フィールド	タイプ	必須	メモ
`model`	文字列	はい	Fish Audio エンジンモデル ID (例: `fishaudio-s21pro-flash`
`input`	文字列	はい	合成するテキスト
`voice`	文字列またはオブジェクト	はい	音声 ID 文字列、または `{ "id": "00a1b221-6137-4b73-ad62-b0cbce134167" }` などのオブジェクト
`response_format`	文字列	いいえ	`mp3`、`wav`、または `pcm`;デフォルトは `mp3`
`speed`	番号	いいえ	通話速度は`0.5`から`2`まで。デフォルトは `1`

GET /api/open/v1/voices から音声 ID を取得します。簡単な接続テストには、パブリックシステムボイス 00a1b221-6137-4b73-ad62-b0cbce134167 を使用します。サポートされている Fish Audio TTS モデル ID を使用します。 tts-1 などの OpenAI モデル名は、Fish Audio モデルのエイリアスではありません。

一部のサードパーティクライアントは、OpenAI 互換の音声リストを通じて音声を検出します。彼らは以下を呼び出すことができます:

GET /v1/audio/voices
Authorization: Bearer YOUR_API_KEY

返された voices[].id 値を音声リクエストの voice として使用します。

＃＃応答

リクエストが成功すると、バイナリオーディオが返されます。

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-OpenAPI-Quota-Remaining: 987988
X-OpenAPI-Credits-Used: 12

<binary audio data>

クライアントは、Content-Type に従って応答を保存または再生する必要があります。エラーは JSON 応答であり、ネイティブ同期エンドポイントと同じ認証、クォータ、生成動作を使用します。

curl の例

curl -X POST "https://fishaudio.org/v1/audio/speech" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fishaudio-s21pro-flash",
    "input": "Hello from Fish Audio.",
    "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "response_format": "mp3",
    "speed": 1
  }' \
  --output speech.mp3

タボを接続する

API キー、ベース URL、モデル、音声、文字バインディングの設定については、専用の Fish Audio TTS for Tavo ガイドに従ってください。

エラー

ステータス	意味	アクション
`400`	無効な入力、音声、モデル、フォーマット、または速度	再試行する前にリクエストを修正してください。
`401`	API キーが見つからないか無効です。統合キーを確認または交換する
`402`	API クォータが不十分です	さらにオーディオを生成する前にクォータを追加する
`429`	リクエストレート制限を超えました	指数バックオフを使用して再試行
`500`	TTS の生成に失敗しました	重複請求を認識してのみ再試行

OpenAI互換品 TTS

OpenAI 互換 TTS

curl の例

タボを接続する

エラー

このページ