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

完整網址：

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; OpenAI 型號名稱（例如 tts-1）不是 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 指南。

錯誤