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 匹配,构建角色的工作由你负责。你将角色设定为系统消息,保留对话历史,并在每次请求中发送。这让你能控制语气、记忆和节奏,这是封闭产品很少提供的。对所有用户的硬性限制相同:永远不允许涉及未成年人的性内容。
五步获取密钥
整个过程只需几分钟。开始时无需银行卡。
- 注册。 使用 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 列表。现在发送第一个带有小型角色的聊天请求。系统消息设定角色,用户消息开始场景。
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 中使用密钥
更改两个值后,任何 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 的功能和限制,常见误区与事实 文章涵盖了常见的误解。