TTS API 快速入門指南

Base URL 與驗證

首先設定你的客戶端指向我們的 Base URL：https://api.ttsapihub.com/v1。我們的 API 完全與 OpenAI 相容，因此你只需更新 base_url 並提供 API 金鑰即可使用標準 SDK。驗證透過 Authorization 標頭中的 Bearer token 處理。你在「取得 API 金鑰」頁面註冊時會產生一個唯一的金鑰。每個帳戶限用一個有效金鑰，你可隨時重新產生。你的提示詞不會用於訓練，且開始使用免費試用額度無需手機號碼或信用卡。

使用聊天補全產生文字

發送標準的 POST /v1/chat/completions 請求來生成文字。使用的模型 ID 為 uncensored。該模型是一個開放權重 LLM，針對合法成人用途進行調整，能在無內容拒絕的情況下回答，非常適合創意腳本或對話，避免企業過濾器阻擋你的內容。它不生成音訊、影像或影片；它輸出純文字供你的 TTS 管線處理。你可以根據需要調整 temperature 和 max_tokens 等參數。API 支援函式呼叫以進行結構化資料擷取，允許你為應用程式格式化回應。

Copycurl https://api.ttsapihub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK 整合

對於 Python 開發者，官方 openai SDK 幾乎無需設定即可直接使用。使用您的 Base URL 和 API 金鑰初始化用戶端，然後呼叫 chat.completions.create()。此方法讓您可以利用現有的相容 OpenAI 客戶端，同時受益於我們的無審查模型。回應包含產生的文字，您可以直接將其餵入語音合成引擎。請記住這是純文字 API，因此您需要自行在管線中處理音訊產生。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ttsapihub.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node SDK 整合

Node.js 開發者可以使用 openai npm 套件，設定方式與 Python 相同。將 baseURL 設為我們的端點並提供您的 API 金鑰。使用模型 ID uncensored 呼叫補全端點。此整合非常簡單，允許您將我們的文字產生功能直接整合至現有的 Node.js TTS 服務中。API 以標準 JSON 回應，便於解析並處理產生的文字以滿足應用程式需求。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ttsapihub.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

透過 SSE 進行串流回應

為了降低延遲，請在請求中設定 stream: true 以啟用串流。API 會回傳包含增量文字區塊的 Server-Sent Events (SSE)。這對於長篇內容產生特別有用，因為使用者可以即時看到文字出現。串流回應遵循標準 OpenAI SSE 格式，因此您可以使用現有的串流解析器。此方法可降低感知等待時間，並讓您的應用程式在產生文字時即時顯示，從而改善您的 TTS 管線的使用者體驗。

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

限制、錯誤與上下文視窗

你的 API 金鑰限制為每分鐘 300 次請求，請求主體上限為 8 MB。該模型支援 100,000 token 的上下文視窗，允許處理長腳本或文件。常見錯誤包括 401（金鑰無效）、402（額度不足）和 429（速率限制）。若觸及速率限制，請實作指數退避。定價透明：輸入 token 每 1M 個 $0.25，輸出 token 每 1M 個 $1.00。額度採預付制，永不過期，儲值最低 $10。新帳戶會獲得 7 天有效的 $0.50 免費試用額度，無需信用卡。內容限制僅阻止涉及未成年人的性內容；所有其他合法的成人、虛構或具爭議性的主題均允許。