Character AI API 金鑰:如何取得與使用
如果你搜尋 Character AI API 金鑰,首先要知道本站不是 Character.ai,也不發行其金鑰。本站提供獨立、OpenAI 相容的文字 API 金鑰,可作為角色聊天應用程式的即用後端。
更新

重點摘要
- 使用 Google 或電子郵件與密碼登入後,開啟 API 金鑰頁面即可取得金鑰。
- 新用戶可一鍵領取 $0.50 免費試用額度,無需信用卡,有效期 7 天。
- 使用Base URL https://api.characteraiapi.com/v1 與模型 ID
uncensored搭配任何 OpenAI SDK。 - 將金鑰保留在伺服器或環境變數中,切勿放在公開的前端程式碼裡。
你實際取得的是什麼
Character.ai 是消費型聊天產品。搜尋 Character AI API 金鑰 的人通常想要兩件事之一:從自有程式呼叫角色聊天機器人,或為不受託管產品規則限制的角色應用程式提供後端。本站滿足第二種需求。你註冊後取得金鑰,向 OpenAI 相容端點發送請求。這裡與 Character.ai 無關,也不重用其角色。
此服務是託管文字 API,後方使用單一開放權重模型,由獨立供應商運行並針對合法成人用途調整為無內容拒絕回應。它不是任何模型供應商的官方 API,也不是跨供應商的路由器。模型 ID 為 uncensored,Base URL 為 https://api.characteraiapi.com/v1。提供兩種方法:POST /v1/chat/completions 與 GET /v1/models。
由於介面與 OpenAI 相符,角色建構的工作在你端。你將角色設定寫入 system message,保留對話歷史,並在每次請求時傳送。這讓你掌控語氣、記憶與節奏,這是封閉產品很少提供的。對所有使用者而言,硬性限制相同:絕不允許涉及未成年人的性內容。
五步驟取得金鑰
整個流程只需幾分鐘。開始不需要信用卡。
- 註冊。使用 Google,或以電子郵件和密碼註冊。
- 開啟金鑰頁面。 前往 API 金鑰頁面,即可看到帳戶金鑰。
- 領取試用。 在該頁面一鍵新增 $0.50 免費試用額度。每人限領一次,有效期 7 天。
- 複製金鑰。 立即將其儲存至密碼管理器或機密檔案。
- 發送測試請求。 在碰觸任何應用程式程式碼之前,先使用下方的 curl 指令。
將金鑰視為密碼。任何擁有金鑰的人都能消耗你的餘額。若懷疑金鑰外洩,請立即停止使用、從所有應用程式中移除,並檢查是否有異常支出。
使用 curl 測試金鑰
將金鑰設為環境變數,避免在腳本中以純文字形式落入 shell 歷史記錄。接著列出模型。這可確認金鑰有效且連接到正確的伺服器。
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"你應獲得包含 uncensored 的 JSON 列表。現在使用小型角色設定發送第一個聊天請求。system message 設定角色,user message 開始場景。
curl https://api.characteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
{"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
],
"temperature": 0.9
}'回應遵循標準聊天完成格式。回覆文字位於 choices[0].message.content。回應標頭也包含 X-Request-Id、X-Balance-USD 與速率限制標頭,這在你想在自有 UI 顯示剩餘餘額時很有幫助。
從 Python 或 Node 使用金鑰
只要更改兩個值:Base URL 與金鑰,任何 OpenAI SDK 皆可運作。以下是使用官方 openai 套件 Python 版本。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.characteraiapi.com/v1",
api_key=os.environ["API_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
{"role": "user", "content": "Status report?"},
],
)
print(reply.choices[0].message.content)Node 中的相同呼叫:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.characteraiapi.com/v1",
apiKey: process.env.API_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are Mara, a ship engineer. Stay in character." },
{ role: "user", content: "Status report?" },
],
});
console.log(reply.choices[0].message.content);許多聊天前端都有自訂 OpenAI 相容端點的欄位。在這些工具中貼上 Base URL、貼上金鑰,並將 uncensored 輸入為模型名稱。其他無需更改。說明文件頁面 列出支援的參數,包括串流輸出、函式呼叫與 JSON 模式。
常見金鑰問題與快速修復
大多數初次失敗來自少數小錯誤。在懷疑更大問題前,依此順序檢查。
- 金鑰中的額外空白或引號。 從檔案複製的尾端換行足以導致驗證失敗。列印變數長度並與你複製的內容比較。
- Base URL 錯誤。 Base URL 以
/v1結尾,SDK 會自行附加/chat/completions。若你也在 Base URL 加上/chat/completions,路徑會重複導致請求失敗。 - 模型名稱錯誤。 模型 ID 為
uncensored。從其他服務借用的名稱將無法匹配。呼叫GET /v1/models查看伺服器回報的內容。 - 遺漏標頭。 原始 HTTP 呼叫需要
Authorization: Bearer後接空白與金鑰,POST 請求需加上Content-Type: application/json。 - 餘額為空。
X-Balance-USD回應標頭顯示剩餘金額。當免費試用額度耗盡或超過 7 天,請儲值否則請求將失敗。 - 速率限制。試用金鑰允許 2 個並行請求,每分鐘 60 個。兩個串流輸出已佔用所有槽位。
無效金鑰通常會產生驗證錯誤,而非模型回覆。速率限制會回傳 HTTP 429 狀態碼,並附上 rate_limited 或 concurrency 程式碼。閱讀錯誤訊息主體(而不僅是狀態碼)可節省時間,因為程式碼會告訴你觸及了哪項速率限制。每個回應都帶有 X-Request-Id;請將其保留在日誌中,以便稍後將失敗的呼叫與特定請求進行比對。
試用限制與試用額度用途
試用金鑰的限制較完整金鑰低:2 個並行請求和每分鐘 60 個請求。完整金鑰允許 8 個並行請求和每分鐘 300 個請求。對於測試單一角色已足夠。如果你從測試腳本同時執行多個聊天,你會看到 HTTP 429 錯誤,錯誤代碼為 concurrency 或 rate_limited。串流輸出的請求會佔用其並行槽位,直到串流結束,因此試用金鑰上的兩個開啟串流會佔滿槽位。
$0.50 能換多少?價格為每 1M 輸入 token $0.15,每 1M 輸出 token $0.50。考慮典型聊天回合:1,500 token 歷史與角色設定輸入,300 token 輸出:
- 輸入:1,500 token x $0.15 / 1,000,000 = $0.000225
- 輸出:300 token x $0.50 / 1,000,000 = $0.00015
- 一回合:$0.000375
- $0.50 / $0.000375 約為 1,333 回合
這足以正確測試多個角色。失敗或遭拒的請求不會扣款,因此出錯的請求不會消耗你的額度。試用期在 7 天後結束;你之後購買的額度不會過期。
讓角色設定更貼切的設定
金鑰提供連線;角色的品質來自提示詞和採樣設定。養成幾個習慣比聰明的小技巧更管用。
將系統訊息撰寫成簡短的角色設定表,以平實的句子描述:角色是誰、說話方式、目標為何,以及回覆長度應為何。若語氣很重要,提供一兩行對話範例。模型對具體範例的遵循度優於形容詞,因此「Mara 以簡短、乾巴巴的句子回答,緊張時會開玩笑」比「Mara 機智且迷人」更有效。
使用 temperature 設定靈活性。接近 0.9 的值會產生更多變化的措辭,而接近 0.5 的值則讓角色更穩定。如果你的應用程式使用類似 "User:" 的說話者標籤,請加入 stop 序列,以防止模型寫出對話的另一方。頻率懲罰和存在懲罰可以減少長對話中的重複短語,但請溫和地提高這些值,因為過高的值可能會使對話變得怪異。
請記住,模型只知道請求中的內容。如果角色需要記住 200 則訊息前的玩家名稱,請保留該訊息在上下文視窗中,或將關鍵事實儲存至系統訊息。這就是為什麼由你自行更新的記憶清單,通常比傳送龐大的歷史紀錄更有效。
試用額度耗盡時進行儲值
沒有訂閱制。你預付並按 token 消耗。儲值金額可以是 $20 到 $500 之間的任何整數金額,且金額較大時享有加成:$50 起 +5%,$100 起 +10%,$200 起 +15%。因此 $50 會變成 $52.50 的額度,$100 變成 $110,$200 變成 $230。你可以使用加密貨幣(TRC20 上的 USDT、Base 上的 USDC)付款。
定價頁面有完整的表格。為了規劃,一次 1,500 token 輸入、300 token 輸出的對話成本為 $0.000375,因此 $20 大約可涵蓋 53,000 次此類對話。長期角色扮演每次對話的成本較高,因為歷史記錄會增長,因此請限制你重新傳送的歷史記錄量。上下文視窗為 100,000 個 token,包含提示詞與補全文本,但你通常不需要將其填滿。
在實際應用程式中妥善保管金鑰
聊天專案最常見的錯誤是直接在瀏覽器程式碼中呼叫 API。任何傳送到瀏覽器的內容都可以被每位訪客讀取,包括金鑰。在你的前端和 API 之間放置一個小型伺服器。瀏覽器與你的路由通訊,你的路由加上 Authorization: Bearer 標頭並轉發請求。
- 將金鑰儲存於環境變數或金鑰管理員中,不要放在程式碼儲存庫內。
- 在第一次提交前,將
.env項目加入.gitignore。 - 每個環境使用一個金鑰,這樣開發環境的洩漏就不會影響生產環境。
- 監控
X-Balance-USD標頭,以便及早發現無止境的迴圈。 - 遇到 HTTP 429 時進行重試,並短暫等待。臨時超載回應包含
Retry-After: 5。
傳送至 API 的提示詞不會用於訓練。即便如此,仍請避免傳送你不希望儲存在你自己端日誌中的資料。如果你想更深入地了解此類 API 的功能與限制,迷思與事實文章 涵蓋了常見的誤解。