Character AI API 整合指南

為什麼要用 API 取代 Character AI？

Character AI 很方便，但它將您的角色鎖定在其生態系統中。您無法儲存完整的上下文視窗、調整模型參數，或確保資料保持私密。API 解決方案如 uncutly AI 讓您直接存取無審查的 LLM。您可以控制提示詞、溫度以及停止序列。這意味著您的角色行為完全符合您的期望。

專有平台經常拒絕完全合法的內容。它們可能因為敏感關鍵字而切斷故事。透過無審查聊天機器人 API，由您決定允許什麼。您獲得單一且可靠的文字生成端點。當您建構依賴穩定角色行為的產品時，這種可靠性至關重要。您不必受制於平台任意審核團隊的擺佈。

步驟 1：取得您的 API 金鑰

先在供應商的後台建立帳戶。您可以使用 Google 帳戶登入，或使用簡單的電子郵件和密碼。不需要手機號碼。註冊後，請前往 API 金鑰區段。系統會立即產生唯一的金鑰。複製此金鑰並將其安全地儲存在您的環境變數中。

每次對 API 的請求都必須在標頭中包含此密鑰。如果密鑰缺失或無效，服務器將返回 401 錯誤。您會獲得一小筆試用信用額度以在花費金錢之前測試集成。該試用信用額度有效期為 7 天。這是驗證您的設置是否正確運行的好方法。

步驟 2：設定 Base URL

大多數現代 LLM 客戶端期望採用與 OpenAI 相容的介面。您需要將您的 SDK 指向正確的基礎 URL。對於此服務，端點為 https://api.uncutlyai.com/v1. 此 URL 結構與標準 OpenAI API 相符。這意味著您可以使用現有的函式庫而無需大幅更改程式碼。

更新您的配置物件以包含此基礎 URL。此外，在授權標頭中設定 API 金鑰。您將使用的模型 ID 僅為 "uncensored"。此模型經過調整，拒絕率更低，創意自由度更高。它能很好地處理長達 100,000 個 token 的長上下文。此長度足以容納深度的角色歷史。

步驟 3：發送您的第一個聊天完成請求

建構一個請求至 /v1/chat/completions 主體應包含一個訊息列表。每個訊息都有角色，例如 "system"、"user" 或 "assistant"。系統訊息定義角色的個性。使用者訊息推動對話進行。

以下是您結構化請求的方法：

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

傳送此請求以查看模型的回覆。伺服器處理 token 並返回文字補全。您可以設定參數，例如 temperature 控制創造力。較高的值會讓角色更不可預測。較低的值則使其更具一致性。這種靈活性讓您能微調語音。

步驟 4：處理串流回應

如果整個回應都要等到最後才顯示，聊天應用程式會感覺遲緩。串流傳輸可以解決這個問題。設定 stream 設為 true。伺服器會回傳一系列 Server-Sent Events (SSE)。每個事件包含一小段文字。

您的客戶端程式碼必須解析這些區塊並即時顯示，以營造人類打字的錯覺。這顯著改善了使用者體驗。最後一個區塊通常包含 token 使用統計數據。您可以利用此數據準確追蹤您的成本。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.uncutlyai.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)

確保您的串流處理程式捕獲任何網路錯誤。中斷的串流可能讓 UI 停留在載入狀態。當串流完成或失敗時，請務必關閉連線。

步驟 5：管理 Token 與成本

理解 token 成本對於預算編制至關重要。您按百萬 token 付費。輸入 token 每百萬成本為 $0.15。輸出 token 每百萬成本為 $0.50。您只需為處理過的 token 付費。錯誤不會收費。拒絕也不會收費。

這種預付模式非常透明。您可以使用加密貨幣充值。最低充值金額為 $20。每次最多加入 $500。沒有月度訂閱。您的信用額度永不過期。這種可預測性有助於您規劃開發成本。您清楚知道每次對話的成本。

步驟 6：實作函式呼叫

進階角色通常需要與外部工具互動。函數調用允許模型返回結構化數據。您可以定義函數的 schema，模型會根據對話內容決定何時調用。

例如，角色可能需要查詢天氣。您將函數定義發送到請求中。模型會回應一個包含函數名稱和參數的 JSON 物件。您的程式碼執行該函數並將結果回傳給模型。

Copyimport OpenAI from "openai";

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

此循環持續到模型生成最終文本回應為止。它實現了動態、互動的故事。你不僅限於靜態文本輸出。模型可以在你的應用程序中觸發事件。

步驟 7：錯誤處理與限制

API 有限制。您可以每分鐘發送 300 次請求。同時只能有 8 個請求處於活動狀態。請求主體必須在 8 MB 以下。如果您超過這些限制，將收到 429 錯誤。在重試邏輯中實施指數退避。

優雅地處理網路錯誤。如果伺服器傳回 500 錯誤，請等待並重試。不要假設模型總是會成功。記錄這些錯誤以識別模式。頻繁的超時可能表示您需要調整超時設定。

步驟 8：擴展您的整合

隨著您的用戶群增長，您的 API 使用量將增加。密切監控您的令牌消耗。使用串流響應中的使用數據來追蹤成本。如果您注意到高成本，請考慮優化您的提示。較短的系統提示可以減少輸入令牌。

考慮緩存常見響應。如果多個用戶詢問同一問題，請提供緩存結果。這可以減少 API 調用並節省費用。你也可以在自己的服務器上實施速率限制。這可以防止單一用戶耗盡你的所有餘額。設計良好的集成保持快速且可靠。