Elevenlabs API 檢查清單：生產環境 TTS 管線指南

為什麼文字品質決定 TTS 品質

任何 TTS 管線的輸出品質取決於輸入文字。如果你的 LLM 生成生硬的措辭、不一致的標點符號或意外的中斷，ElevenLabs API 會完全按照書面內容將其語音化。這就是為什麼文字生成步驟通常是架構中最關鍵的部分。

標準模型通常會套用企業安全過濾器，為了避免爭議性話題，可能會截斷句子或改變對話中的語氣。對於創意寫作、遊戲或成人內容流程，這些中斷會破壞沉浸感。無審查 LLM 可確保您的腳本完全按照您的意圖傳送至 TTS 引擎，保留細節與流暢度。

• 檢查長文本中角色聲音的一致性。
• 確保標點符號符合預期的說話節奏。
• 驗證安全過濾器是否會重寫關鍵對話。

如果你的文字管線使用標準模型，當主題跨越隱藏閾值時，你可能會看到突然的語調變化。切換到為創作自由而調整的模型可以消除此變數。

無審查腳本以獲得創作自由

當為故事敘述、有聲書或互動式小說建構應用程式時，您需要一個不會根據任意指南拒絕內容的文字引擎。我們的 API 提供 無審查 LLM，針對合法成人用途、安全研究與創意小說進行最佳化。

該模型識別為 uncensored，運行於我們自己的 GPU 伺服器上，且不會將您的提示詞用於訓練。它支援透過 SSE 進行串流輸出，讓您能夠幾乎立即開始生成音訊文字區塊。

我們按每 1M 輸入 token 收取 $0.25，每 1M 輸出 token 收取 $1.00。沒有月費，預付額度永不過期。這種隨用隨付模式與任何 OpenAI 相容的客戶端無縫整合，包括標準的 ElevenLabs 文字輸入。

• 支援用於結構化輸出的工具/函式呼叫。
• 100,000 token 上下文視窗，適用於長篇敘事。
• 標準成人或爭議性主題無內容拒絕。

串流文字至 ElevenLabs API

低延遲對於即時 TTS 應用程式至關重要。雖然 ElevenLabs 支援音訊串流，但文字生成層也必須進行串流以最小化首字節時間。請使用標準 OpenAI 相容端點 POST /v1/chat/completions 並搭配 stream: true。

即時接收文字區塊並直接將其饋送至 ElevenLabs 串流音訊端點。這建立了一個連續的管線，使得在整個腳本生成之前音訊即可播放。

我們的 API 支援 SSE（伺服器發送事件），使你可以輕鬆將文字直接導入音訊引擎。確保你的客戶端能優雅地處理不完整句子，以避免音訊故障。

• 在你的 LLM 客戶端中啟用串流。
• 緩衝隨到達的音訊區塊。
• 透過僅重試遺失的區塊來處理網路中斷。

處理長篇敘事的上下文視窗

您用於文字生成的 tts api 必須能夠處理長上下文視窗，如果您正在製作有聲書或長篇文章。我們的模型支援 100,000 個 token，這大約涵蓋 40-50 頁的文字。

如果你的敘事超過此限制，你必須實施分塊策略。將文字分割為邏輯區塊，透過 API 處理每個區塊，然後將結果連接起來。小心不要在區塊之間失去敘事連貫性。

密切監控你的 token 使用情況。輸入 token 比輸出 token 便宜，但長提示詞仍會累積。在發送大型文字之前預先計算 token 數量，以避免意外成本。

• 按章節或場景分割文字。
• 傳遞系統提示詞以維持聲音一致性。
• 快取已完成的區塊以避免重新處理。

用於結構化對話的工具呼叫

對於複雜的應用程式，僅有純文字是不夠的。使用函式呼叫來生成包含 voice ID、情緒標籤與中繼資料的結構化 JSON。這可確保您的 ElevenLabs API 呼叫具有一致性與可預測性。

定義一個包含 voice_id、stability 與 similarity_boost 欄位的 schema。LLM 會輸出此 JSON，您的後端會解析並傳送給 ElevenLabs。這可減少手動設定並防止錯誤。

我們的 API 原生支援函式呼叫。在 tools 參數中定義您的工具，並讓模型決定何時使用它們。這非常適合動態角色或多語者對話。

• 定義語音參數的 JSON 架構。
• 在呼叫 TTS API 之前解析 LLM 輸出。
• 如果 LLM 遺漏欄位，請優雅地處理錯誤。

隱私：不對你的腳本進行訓練

對於專業內容創作者來說，隱私至關重要。我們的 API 確保你的提示詞不會用於訓練。當你註冊時，你僅提供電子郵件和密碼，你的資料保持安全。

與某些免費層不同，我們不使用你的文字來改進我們的模型。這對於專有故事、商業腳本或個人資料至關重要。你的創作作品仍屬於你。

我們也執行嚴格的内容限制：不涉及未成年人的性內容。這是應用於你合法內容的唯一限制。其他一切都可以用於你的管線。

• 不對你的提示詞進行訓練。
• 最小化的註冊要求。
• 清晰的内容界限。

限制你的 TTS API 請求

速率限制不僅是禮貌，更是穩定生產環境的必要條件。我們的 API 允許每個金鑰每分鐘 300 個請求。如果您超過此限制，將會收到 429 錯誤。

在你的客戶端實作指數退避機制，以有效處理重試。若可避免，請勿以並行請求轟炸 API。使用佇列來管理大量工作。

監控你的使用儀表板以追蹤消耗量。若你需要更高的限制，請考慮重新產生 API 金鑰，這會使舊金鑰失效並重置速率限制計數器。這對於突發流量很有用。

• 設定每分鐘最多 300 次請求。
• 對重試使用指數退避。
• 若需要，請重新產生金鑰以重設限制。

大量 TTS 的成本最佳化

成本控管對於擴展至關重要。我們的 API 對每 1M 輸入 token 收取 $0.25，對每 1M 輸出 token 收取 $1.00。這在無審查模型中具有競爭力，但成本可能會迅速累積。

透過移除不必要的空白和上下文來最佳化你的提示詞。使用函式呼叫來減少往返次數。預先計算 token 數量以保持在預算內。

我們提供預付額度並附贈獎金。存入 $50 可獲得 5% 獎金，或存入 $100 獲得 10% 獎金。這能顯著降低每個 token 的有效成本。

• 每日監控 token 使用量。
• 使用預付額度以獲得折扣。
• 最佳化提示詞長度。