使用 fish.audio 風格的 POST /v1/tts 合約，搭配 Fish Audio API 金鑰接入 RikkaHub 等用戶端。

Fish Audio 相容 TTS

當客戶端硬編碼fish.audio POST /v1/tts 請求形狀時使用此端點。它將有效負載對應到 Fish Audio Open TTS 管道，同時在您的 Fish Audio 帳戶上保留 API 金鑰驗證、配額和計費。

對於本機 Open API 集成，首選 Sync HTTP。對於 OpenAI POST /v1/audio/speech 用戶端，請使用 OpenAI-相容於 TTS。

端點

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

完整網址：

https://fishaudio.org/v1/tts

如果第三方應用程式要求 Fish Audio API 基礎（例如 https://api.fish.audio），請將其設為 https://fishaudio.org 並將路徑保留為 /v1/tts。

將 API 金鑰保留在用戶端的受保護憑證欄位中。為每個應用程式建立專用金鑰，以便您可以獨立監控或撤銷它。

＃＃要求

{
  "text": "Hello from Fish Audio.",
  "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "format": "mp3",
  "temperature": 0.7,
  "top_p": 0.7,
  "normalize": true,
  "prosody": {
    "speed": 1
  }
}

欄位/標題	類型	必填	筆記
`model` 標頭	字串	沒有	Fish.audio 引擎標籤，例如 `s2.1-pro`、`s2.1-pro-flash` 或 `s2-pro`
`text`	字串	是的	要合成的文字
`reference_id`	字串	是的	Fish Audio 語音辨識；伺服器不會默默地選擇預設語音
`format`	字串	沒有	`mp3`、`wav` 或 `pcm`；不支援的值（例如 `opus`）會回退到 `mp3`
`prosody.speed`	數量	沒有	說話速度從`0.5`到`2`；頂級的`speed`也被接受
`temperature`	數量	沒有	對應到 Fish Audio 穩定性 (`0.5`–`1.5`)
`top_p`	數量	沒有	對應到 Fish Audio 相似性 (`0.5`–`1.5`)
`normalize`	布林值	沒有	映射到文字規範化
`chunk_length`	數量	沒有	因客戶端相容性而接受並被忽略
`latency`	字串	沒有	因客戶端相容性而接受並被忽略

模型頭映射

`model` 標頭值	Fish Audio 引擎型號 ID
`s2.1-pro`	`fishaudio-s21pro`
`s2.1-pro-free`	`fishaudio-s21pro-free`
`s2.1-flash`	`fishaudio-s21-flash`
`s2.1-pro-flash`	`fishaudio-s21pro-flash`
`s2-pro`	`fishaudio-s2pro`
`s1` / `s1-mini`	`fishaudio-s1`
`speech-1.5` / `1.6`	`fishaudio-s1`

未知的標頭值將被忽略，並套用伺服器預設引擎。您也可以在標頭中傳送本機引擎 ID，例如 fishaudio-s21pro-flash。

從 GET /api/open/v1/voices 取得語音 ID。如需快速連線測試，請使用公共系統語音00a1b221-6137-4b73-ad62-b0cbce134167。

回覆

成功的請求返回二進位音訊：

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

<binary audio data>

錯誤為 JSON，並與 Sync HTTP 共享身份驗證、配額和生成行為。

curl 範例

curl -X POST "https://fishaudio.org/v1/tts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "model: s2.1-pro" \
  -d '{
    "text": "Hello from Fish Audio.",
    "reference_id": "00a1b221-6137-4b73-ad62-b0cbce134167",
    "format": "mp3",
    "prosody": { "speed": 1 }
  }' \
  --output speech.mp3

連接RikkaHub

對於RikkaHub中的API金鑰、基本URL、型號和語音設置，請遵循專用的RikkaHub設定指南。

錯誤

狀態	意義	行動
`400`	無效文字、缺少 `reference_id` 或錯誤的 JSON	重試之前更正請求
`401`	API 金鑰遺失或無效	檢查或更換整合金鑰
`402`	API 配額不足	在產生更多音訊之前新增配額
`429`	請求速率超出限制	使用指數退避重試
`500`	TTS生成失敗	僅在具有重複充電意識的情況下重試

Fish Audio 相容 TTS

Fish Audio 相容 TTS

端點

模型頭映射

回覆

curl 範例

連接RikkaHub

錯誤

本頁內容