TTS API 基礎 URL：它是什麼以及該輸入什麼

Base URL，以及一個首先要知道的事

如果您是搜尋 tts api 基本 URL 來到這裡，在複製任何內容前請先檢查一個細節：此網站背後的服務是文字語言模型 API，而非語音合成器。基本 URL 為 https://api.ttsapihub.com/v1，它提供 POST /v1/chat/completions 和 GET /v1/models。沒有 /audio/speech 路由，沒有語音列表，也沒有音訊輸出。

這很重要，因為許多工具會泛化標示其設定。客戶端中名為 base URL 的欄位，無論後端伺服器回傳文字還是聲音，運作方式都相同。如果你的目標是將文字轉為語音，此端點無法達成。如果你的目標是生成語音工具稍後會朗讀的文字，例如腳本、對話或旁白草稿，則非常適合。在規劃此類工作流程時，請查看網站的 TTS 管線檢查清單，而 快速入門文件列出了所有請求參數。

本頁其餘內容適用於任何 OpenAI 相容客戶端，因此即使您只是來了解 Base URL 如何運作，也很有用。

Base URL 的實際定義

API 網址有兩部分。第一部分識別服務及其介面版本。第二部分命名動作。客戶端程式庫會將它們組合在一起。使用 OpenAI SDK 時，各部分如下所示：

部分	說明
Base URL	https://api.ttsapihub.com/v1
SDK 為聊天加入的路徑	/chat/completions
被呼叫的完整網址	https://api.ttsapihub.com/v1/chat/completions
模型列表的路徑	/models

由於 SDK 會附加路徑，你只需提供前半段。這正是透過一行程式碼變更供應商的理念所在：請求格式是共享的，因此唯一需要移動的是請求發送的位置。金鑰也會改變，因為每個服務都會頒發自己的金鑰。模型名稱也會改變，因為每個服務都會命名自己的模型。此 API 的模型 ID 為 uncensored。

兩個小細節可節省時間。版本區段 /v1 屬於基本 URL，因為它標示介面世代；未來不相容的介面會位於不同版本下，且你的程式碼不會變更，直到你選擇移動為止。基本 URL 的尾隨斜線大多數 SDK 都能容忍，但為了安全起見，請不要加上，以免組合路徑出現雙斜線。

驗證是標準的 bearer 標頭：Authorization: Bearer YOUR_KEY。SDK 會從您傳遞的金鑰建立該標頭，因此除非使用 curl，否則您很少需要手寫它。

在程式碼中設定 Base URL

Python

官方的 openai 套件接受 base_url 參數。這是一個完整可運作的呼叫：

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": "Write a two-line scene opening."}],
)
print(resp.choices[0].message.content)

Node

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: "Write a two-line scene opening." }],
});
console.log(resp.choices[0].message.content);

curl

使用 curl 時，您需要自行撰寫完整網址，因此包含路徑：

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": "Say hello."}]}'

環境變數

官方 OpenAI SDK 的較新版本會在你未在程式碼中傳入時，從環境變數讀取 OPENAI_BASE_URL 與 OPENAI_API_KEY。當你想讓既有軟體指向新的端點而不必修改程式碼時，這很方便。請在 Shell 環境或你的程序管理器中設定它們，然後照常執行程式。如果 SDK 未讀取這些變數，請檢查該 SDK 版本的說明文件。

在編輯器和應用程式中設定

接受自訂 OpenAI 端點的工具會要求相同的三個值。名稱不同，因此請尋找以下類型的文字：

• Cursor： 在模型設定中，有一個選項可覆寫 OpenAI 基本 URL。貼上 https://api.ttsapihub.com/v1，加入你的金鑰，並將 uncensored 加入為自訂模型名稱。介面標籤在 Cursor 版本之間會有所變化，因此請將這些名稱視為指南。
• SillyTavern： 選擇 Chat Completion，然後選擇 Custom (OpenAI-compatible) 來源，並填入端點、金鑰和模型。
• Open WebUI 和類似的聊天前端： 使用 Base URL 和金鑰新增 OpenAI 類型連線。
• 你自己的腳本： 任何 HTTP 用戶端皆可運作，因為介面是透過 HTTPS 傳輸的純淨 JSON。

某些工具會透過呼叫 GET /v1/models 來檢查連線。此 API 支援該路由，因此檢查會通過。少數工具僅允許您從固定清單中選擇；如果您的工具如此，請尋找自訂或手動模型欄位，而非下拉選單。

記住工具的用途。像 Cursor 這樣的編輯器會將程式碼問題發送到一般聊天模型，這可以運作。但依賴特殊端點的功能（如程式碼搜尋的嵌入）在此不可用，因為不提供嵌入功能。

導致大多數 Base URL 錯誤的錯誤

幾乎每次首次連線失敗都來自其中一項。

1. 版本重複。 基本 URL 已經以 /v1 結尾。如果你再加一個，網址會變成 /v1/v1/chat/completions，伺服器會回傳找不到錯誤。
2. 貼上完整路徑。 Base URL 欄位需要 https://api.ttsapihub.com/v1，而不是 https://api.ttsapihub.com/v1/chat/completions。SDK 會再次附加路徑。
3. 使用網站網址。 您閱讀的網站不是 API 主機。請求會發送到上述的 api. 主機。
4. 呼叫語音路由。 像 /audio/speech 這樣的路徑在此不存在，並會回傳錯誤。
5. 錯誤或缺失的模型名稱。 始終以小寫傳送 uncensored。
6. 金鑰問題。手寫標頭中的多餘空白或缺少 Bearer 前綴，會導致驗證錯誤。

要區分 URL 問題和金鑰問題，請請求模型清單。正確的 URL 和錯誤的金鑰會導致驗證錯誤。錯誤的 URL 會導致找不到、DNS 錯誤或 HTML 頁面而非 JSON。

Copycurl https://api.ttsapihub.com/v1/models -H "Authorization: Bearer $API_KEY"
# then a minimal chat call with the model ID "uncensored":
curl https://api.ttsapihub.com/v1/chat/completions -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

取得金鑰及其費用

在這些功能運作之前，你需要一個金鑰。在 API 金鑰頁面 使用 Google 或電子郵件與密碼註冊，然後點擊一次即可領取 $0.50 的試用額度。有效期為 7 天，每人限領一次，且不需要信用卡。試用金鑰允許 2 個並行請求和每分鐘 60 個請求，而完整金鑰則允許 8 個並行請求和每分鐘 300 個請求。

定價為每 1M 輸入 token $0.15 及每 1M 輸出 token $0.50，從預付額度扣除，無訂閱費。一次包含 2,000 個輸入 token 和 500 個輸出 token 的請求費用為 $0.0003 加上 $0.00025，共 $0.00055。儲值金額從 $20 到 $500 不等，$50 以上有贈金，可透過信用卡（Visa、Mastercard、Apple Pay、Google Pay）或加密貨幣（TRC20 上的 USDT、Base 上的 USDC）付款。定價頁面 有完整表格。提示詞不會用於訓練，該模型僅供合法成人使用，不涉及未成年人的性內容。

更多指南

• SillyTavern 免費 API：試用額度與設定
• Python 中的 TTS API 金鑰：設定、串流輸出、JSON 模式
• Elevenlabs API 檢查清單：無審查 TTS 管線