中文 ▾
获取 API 密钥

Character AI API 密钥:如何获取和使用

如果你搜索了 Character AI API 密钥,首先要知道的是,本站不是 Character.ai,也不发放其密钥。它提供独立、OpenAI 兼容的文本 API 密钥,可作为角色聊天应用的即插即用后端。

聊天面板上方发光的密钥连接到服务器立方体,说明 API 密钥访问

要点

  1. 使用 Google 或邮箱密码登录后,打开 API 密钥页面即可获得密钥。
  2. 新用户可一键领取 $0.50 试用额度,无需银行卡,有效期 7 天。
  3. 使用 Base URL https://api.characteraiapi.com/v1 和模型 ID uncensored 配合任何 OpenAI SDK 使用。
  4. 将密钥保存在服务器或环境变量中,不要放在公共前端代码中。

你实际获得的内容

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 匹配,构建角色的工作由你负责。你将角色设定为系统消息,保留对话历史,并在每次请求中发送。这让你能控制语气、记忆和节奏,这是封闭产品很少提供的。对所有用户的硬性限制相同:永远不允许涉及未成年人的性内容。

五步获取密钥

整个过程只需几分钟。开始时无需银行卡。

  1. 注册。 使用 Google,或使用邮箱和密码注册。
  2. 打开密钥页面。 前往 API 密钥页面,此处显示你账户的密钥。
  3. 领取试用。 在该页面点击一次即可添加 $0.50 试用额度。每人限领一次,有效期 7 天。
  4. 复制密钥。 立即将其存储在密码管理器或密钥文件中。
  5. 发送测试请求。 在接触任何应用代码之前,先使用下面的 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 的功能和限制,常见误区与事实 文章涵盖了常见的误解。

问答

这会给我 Character.ai API 密钥吗?

不会。这是一个单独、独立的服务。你获得一个 OpenAI 兼容接口的密钥,模型 ID 为 uncensored,你可以将其用作自己角色应用的后端。

获取密钥需要银行卡吗?

不需要。你使用 Google 或电子邮件和密码注册,然后在 API 密钥页面一键领取 $0.50 的试用额度。试用额度有效期为 7 天。

我可以在 SillyTavern 或其他聊天前端中使用该密钥吗?

接受自定义 OpenAI 兼容接口的工具都可以使用它。输入Base URL、你的密钥和模型名称 uncensored。

当我达到速率限制时会发生什么?

API 返回 HTTP 429,代码为 rate_limited 或 concurrency。等待片刻并重试。试用密钥允许 2 个并发请求和每分钟 60 个请求。

额度会过期吗?

购买的额度永不过期。只有 $0.50 的试用额度有 7 天的有效期。

只差一张表单,即可获得密钥

创建账户,复制密钥,更改Base URL。这就是全部设置。

获取 API 密钥