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。此外，在 authorization 请求头中设置 API 密钥。您将使用的模型 ID 仅为 "uncensored"。该模型经过优化，拒绝率更低，创意自由度更高。它能很好地处理长上下文，最多支持 100,000 个 token。此长度允许包含深度的角色历史。

步骤 3：发送您的第一个聊天补全请求

构造一个请求到 /v1/chat/completions 端点。请求体应包含一个消息列表。每条消息都有一个角色，如 "system"、"user" 或 "assistant"。system 消息定义角色的性格。user 消息驱动对话。

以下是如何构建请求：

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。服务器返回一系列服务器发送事件 (SSE)。每个事件包含一小块文本。

您的客户端代码必须解析这些块并实时显示它们。这创造了人类打字的错觉。它显著改善了用户体验。最后一个块通常包含令牌使用统计信息。您可以使用此数据准确跟踪成本。

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 和成本

理解令牌成本对于预算编制至关重要。您按百万令牌付费。输入令牌每百万令牌成本为 $0.15。输出令牌每百万令牌成本为 $0.50。您只为处理的令牌付费。错误不会收费。拒绝也不会收费。

这种预付费模式透明公开。您使用加密货币充值。最低充值金额为 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 调用并节省资金。你还可以在自己的服务器上实施速率限制。这可以防止单个用户耗尽你的所有信用。一个良好扩展的集成保持快速和可靠。