Character AI API：三行程式碼即可切換客戶端

先決條件

在編寫程式碼之前，您需要 characteraiapi.com 的有效帳號。前往取得 API 金鑰頁面，僅使用電子郵件和密碼註冊即可開始，無需信用卡。新帳號會獲得 $0.50 的免費試用額度，有效期為 7 天。註冊後，您的 API 金鑰會立即顯示。請妥善保管此金鑰，因為它用於對端點的所有請求進行身份驗證。您還需要在開發環境中安裝支援的語言 SDK。character ai api端點接受標準 OpenAI 參數，因此任何現有的 OpenAI 相容客戶端只需少量修改即可運作。

安裝 SDK

對於 Python 專案，請使用 pip 安裝官方 OpenAI 套件。此程式庫會自動處理 JSON 序列化和 HTTP 請求。對於 Node.js 應用程式，請使用 npm 新增openai套件。這兩個程式庫都支援本指南稍後描述的串流輸出和工具呼叫功能。確保您的 SDK 版本足夠新，以支援用於即時 token 串流輸出的 Server-Sent Events (SSE)。如果您使用的是自訂 HTTP 客戶端而非 SDK，則必須根據 OpenAI API 規格手動處理 JSON 載荷和 SSE 串流輸出解析。

身份驗證

每個請求都必須在Authorization標頭中包含您的 API 金鑰。使用格式Bearer YOUR_API_KEY。所有請求的基礎 URL 為https://api.characteraiapi.com/v1。使用 SDK 時，將base_url設定為此值，並透過api_key參數提供您的金鑰。如果您遺失金鑰或懷疑洩漏，可以從儀表板重新產生；舊金鑰將立即失效。每個帳號只允許一個有效金鑰。請確保使用正確的基础 URL，因為對標準 OpenAI 端點的請求將以 404 或 401 錯誤失敗。

基本聊天完成

核心功能透過/v1/chat/completions端點提供。發送 POST 請求，模型名稱設為uncensored並附上您的對話歷史。該模型會回傳文字輸出，且不對合法的成人內容套用標準內容篩選。以下 curl 範例展示了簡單的文本完成請求。

Copycurl https://api.characteraiapi.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."}]
  }'

此請求回傳包含生成文本的完成物件。您可以調整temperature等參數以控制隨機性，或設定max_tokens以限制輸出長度。該模型支援 100,000 token 的上下文視窗，允許在單一請求中處理大量的對話歷史或長文件。

串流輸出回應

為了獲得更好的使用者體驗，請在請求中設定stream: true以啟用串流輸出。API 會回傳 Server-Sent Events (SSE)，包含生成時的 partial token 區塊。這可降低聊天機器人應用程式的感知延遲。如果您希望在最後一個事件中接收最終的使用統計數據，請使用stream_options參數。串流輸出對於即時角色扮演的聊天機器人特別有用，因為逐字顯示文本可增強沉浸感。確保您的客戶端程式碼正確處理 SSE 格式，以便依序解析每個區塊。

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 次請求的限制。如果超過此限制，您將收到 429 Too Many Requests 錯誤。請求主體限制為 8 MB。常見錯誤包括金鑰無效或缺失時的 401 錯誤，以及預付額度耗盡時的 402 錯誤。您可以使用加密貨幣（USDT 或 USDC）從 $10 開始儲值，較大的存款還可獲得額外額度。與其他一些供應商不同，這裡沒有隱藏費用或訂閱鎖定；您只需為消耗的 token 付費。定價透明：每 1M 輸入 token $0.25，每 1M 輸出 token $1.00。確保您的錯誤處理邏輯在遇到 429 錯誤時以指數退避方式重試。

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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