Xtts 管線快速上手

驗證與 Base URL

首先前往取得 API 金鑰頁面，並使用 Google 或電子郵件密碼登入。您將立即收到唯一的 API 金鑰。請對所有請求使用 Base URL https://api.xtts.cc/v1。此 URL 與官方 OpenAI SDK 以及任何支援 OpenAI chat-completions 格式的客戶端相容。

將你的金鑰以 bearer token 的形式放入 Authorization 標頭中。你必須傳送的模型識別碼為 uncensored。此開放權重模型託管於我們的伺服器上，經過調整以在合法成人用途下提供無內容拒絕的回答，確保你的語音管線能取得所需的原始文字。

生成無審查文字

向/v1/chat/completions發送 POST 請求，並附上您的系統提示詞和使用者提示詞。API 會回傳包含生成文字的結構化 JSON。此端點專為提示詞撰寫、腳本生成以及語音克隆工作流程中的後處理任務而設計。

請求主體包含模型名稱、您的訊息歷史記錄，以及溫度或 top_p 等可選參數。您可以使用max_tokens參數控制輸出長度。如果您未設定max_tokens，回應可能會達到上下文視窗的結尾。

複製curl https://api.xtts.cc/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 整合

使用官方 OpenAI Python SDK 與我們的 API 互動。將base_url設定為我們的端點，並提供您的 API 金鑰。此方法讓您可以利用現有的程式碼結構，同時受益於我們無審查模型的行為。

建立一個帶有 base URL 的客戶端實例，然後呼叫 chat.completions.create。傳入 uncensored 模型 ID 與你的訊息。回應物件會在 content 中包含生成的文字。此方法非常適合批次處理腳本，或將文字生成整合至更大的 Python 應用程式中。

複製from openai import OpenAI

client = OpenAI(base_url="https://api.xtts.cc/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 整合

對於 JavaScript 環境，請使用 OpenAI Node SDK。使用我們的 base URL 和 API 金鑰配置客戶端。此設定可讓你在網頁或伺服器端應用程式中直接生成文字。

使用uncensored模型呼叫聊天完成端點。回應提供生成的文字，您可以將其傳遞給語音合成引擎。此整合適合網頁應用程式或後端服務中的即時文字生成，這些服務為語音克隆準備腳本。

複製import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.xtts.cc/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);

串流回應

透過在請求中將stream設定為 true 來啟用串流。API 會為每個生成的 token 回傳 Server-Sent Events (SSE)。此功能對於即時文字顯示或漸進式語音合成準備非常有用。

每個事件區塊包含部分文字。最後一個區塊包含使用統計數據，例如 token 計數。串流確保您的應用程式可以在生成文字時處理文字，從而降低使用者的感知延遲。處理串流事件以累積完整的回應。

複製stream = 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 個並行請求。請求主體不得超過 8 MB。如果您發送無效的金鑰，將收到 401 錯誤。如果您的預付額度已耗盡，將收到 402 錯誤。超過速率限制將導致 429 錯誤。

上下文視窗總共支援 100,000 個 token，包含提示詞與補全內容。沒有單獨的輸出上限，若希望回覆較短，你可以指定較低的 max_tokens。錯誤與拒絕不會消耗你的預付額度。支援函式呼叫與 JSON 模式，可用於結構化資料擷取。