要開始使用 Fish Audio API 進行文字轉語音(TTS),開發者需要準備 API 金鑰、選擇適合的模型,並發出第一次 TTS 請求。這篇文章將一步步指導你完成這個過程,讓你能夠順利整合語音功能到你的產品或自動化流程中。
本文目錄:核心解釋 | 用途與選擇 | 實作示例 | 成本與限制 | 常見問題 | 下一步
核心解釋
Fish Audio API 是一個強大的文字轉語音服務,開發者可以通過簡單的 API 請求將文字轉換為自然流暢的語音。使用此 API,開發者需要首先創建一個帳戶並獲取 API 金鑰,然後選擇合適的模型來生成語音。API 支援多種輸出格式,如 mp3、wav、pcm 和 opus,並提供了不同的模型選擇以滿足不同的需求。
用途與選擇
Fish Audio API 適用於多種應用場景,包括語音助手、教育應用、遊戲內語音、以及任何需要將文字轉換為語音的產品。選擇模型時,開發者應考慮以下因素:
| 模型名稱 | 特點 | 適用場景 |
|---|---|---|
| s2.1-pro | 高品質語音,適合多種語言 | 一般應用 |
| s2.1-pro-free | 免費使用,無 TTFA/DPA 保證 | 測試或小型專案 |
實作示例
以下是使用 Fish Audio API 進行第一次 TTS 請求的步驟:
import requests
# 步驟 1:設定 API 金鑰
api_key = 'YOUR_API_KEY'
# 步驟 2:設定請求的 URL
url = 'https://api.fish.audio/v1/tts'
# 步驟 3:設定請求的標頭
headers = {
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json',
'model': 's2.1-pro'
}
# 步驟 4:設定請求的數據
data = {
'text': '你好,這是使用 Fish Audio API 的第一次 TTS 呼叫。',
'output_format': 'mp3'
}
# 步驟 5:發送請求
response = requests.post(url, headers=headers, json=data)
# 步驟 6:檢查輸出
if response.status_code == 200:
print('語音生成成功!')
else:
print('語音生成失敗:', response.text)
- 步驟 1:創建帳戶並獲取 API 金鑰。
- 步驟 2:選擇合適的模型標頭。
- 步驟 3:設定請求的 URL 和標頭。
- 步驟 4:發送 TTS 請求。
- 步驟 5:檢查輸出結果以確保成功。
成本與限制
使用 Fish Audio API 時,開發者需注意以下成本與限制:
- 免費模型(s2.1-pro-free)無 TTFA/DPA 保證,適合小型測試。
- 付費計劃根據使用量收費,Starter 計劃每月低於 $100 的用戶可併發 5 次請求。
- 請求的併發限制會根據所選計劃而有所不同。
常見問題
如何獲取 API 金鑰?
你可以通過創建 Fish Audio 帳戶並在 Dashboard 的 API Keys 部分獲取金鑰。
可以使用哪些輸出格式?
Fish Audio API 支援 mp3、wav、pcm 和 opus 格式。
模型選擇有何影響?
不同模型提供不同的語音質量和特點,選擇適合的模型可以提高語音生成的效果。
API 有哪些併發限制?
根據計劃的不同,併發請求的數量會有所不同,Starter 計劃可併發 5 次請求。
如何檢查 API 請求的成功與否?
可以通過檢查 API 請求的回應狀態碼來判斷,狀態碼 200 表示請求成功。
下一步
現在你已經學會如何使用 Fish Audio API 進行第一次 TTS 呼叫,接下來可以進一步探索 API 的其他功能,或考慮參加我們的一對一項目指導,以獲得更深入的學習與實作支持。
查閱日期 2026 年 10 月 15 日。
學習 AI,保護你的未來。