Logo
Project Icon

node_characterai

Node.js客户端简化Character AI角色对话交互

Character AINode.jsAPI聊天机器人认证Github开源项目

node_characterai是Character AI网站的非官方Node.js客户端,提供简洁的API接口。支持访客和令牌登录,异步请求,对话管理,消息收发等核心功能。使用JavaScript编写,接口简单易用,支持图片交互。该项目持续更新,为开发者提供便捷的Character AI功能接入方式。

访问官网访问官网GithubGithub文档文档论文论文
介绍相关项目

Character AI 非官方 Node API

Node.js 客户端用于非官方 Character AI API，这是一个使用 AI 让角色栩栩如生的超棒网站!

简介

本仓库的灵感来自 RichardDorian 的非官方 node API。 不过，我发现它使用起来很困难，而且不太稳定且已被归档。所以我用 JavaScript 重新实现了它。

本项目与 Character AI 没有任何关系!这是一个社区项目。 本项目的目的是引入并构建由 Character AI 驱动的项目。

如果你喜欢这个项目，请查看他们的网站。

特性

  • 👍 完全用 JavaScript 和 CommonJS 编写(为了最大兼容性和易用性)
  • ⌚ 异步请求
  • 🗣️ 使用会话或使用 API 获取信息
  • 🧸 易于使用
  • 🔁 积极开发中
  • 👤 支持访客和令牌登录

安装

npm install node_characterai

使用方法

基本的访客认证和消息发送:

const CharacterAI = require("node_characterai");
const characterAI = new CharacterAI();

(async () => {
  // 以访客身份认证(使用 `.authenticateWithToken()` 来使用账户)
  await characterAI.authenticateAsGuest();

  // 在这里放置你的角色 ID
  const characterId = "8_1NyR8w1dOXmI1uWaieQcd147hecbdIK7CeEAIrdJw";

  // 创建一个聊天对象来与会话交互
  const chat = await characterAI.createOrContinueChat(characterId);

  // 发送消息
  const response = await chat.sendAndAwaitResponse("Hello discord mod!", true);

  console.log(response);
  // 使用 `response.text` 将其作为字符串使用
})();

使用访问令牌

API 的某些部分(如管理会话)需要你使用 sessionToken 登录。

要获取它，你可以打开浏览器，在 localStorage 中访问 Character.AI 网站。

[!重要]
如果你使用的是旧版本的包并收到 Authentication token is invalid 错误，现在你又需要使用 sessionToken 来认证(从 1.2.5 版本开始)。请参见下文。

如果你正在使用某个使用了此包但很久没有更新到最新版本的项目，请确保通过执行 npm update node_characterai 更新包，或手动复制文件，或者向他们的包(如果有)提出相应的问题。

⚠️ 警告: 除非你信任或知道自己在做什么，否则不要与任何人分享你的会话令牌。

任何拥有你会话令牌的人都可能在未经你同意的情况下访问你的账户。风险自负。

在 PC 上:

  1. 在浏览器中打开 Character.AI 网站 (https://beta.character.ai)
  2. 打开开发者工具 (F12, Ctrl+Shift+I, 或 Cmd+J)
  3. 转到 Application 标签
  4. 转到 Storage 部分并点击 Local Storage
  5. 查找 char_token 键
  6. 打开对象，右键点击值并复制你的会话令牌。

Session_Token

在移动设备上:

  1. 在浏览器中打开 Character.AI 网站的旧界面 (https://old.character.ai/)
  2. 打开 URL 栏，输入 javascript: (区分大小写)并粘贴以下内容:
(function(){let e=window.localStorage["char_token"];if(!e){alert("You need to log in first!");return;}let t=JSON.parse(e).value;document.documentElement.innerHTML=`<div><i><p>provided by node_characterai - <a href="https://github.com/realcoloride/node_characterai?tab=readme-ov-file#using-an-access-token">click here for more information</a></p></i><p>Here is your session token:</p><input value="${t}" readonly><p><strong>Do not share this with anyone unless you know what you are doing! This is your personal session token. If stolen or requested by someone you don't trust, they could access your account without your consent; if so, please close the page immediately.</strong></p><button id="copy" onclick="navigator.clipboard.writeText('${t}'); alert('Copied to clipboard!')">Copy session token to clipboard</button><button onclick="window.location.reload();">Refresh the page</button></div>`;localStorageKey=null;storageInformation=null;t=null;})();

  1. 应该会出现以下页面: Access_Token_Mobile

  2. 点击相应的按钮将你的访问令牌或 ID 令牌复制到剪贴板。

使用这个包时，你可以:

  • 使用 authenticateAsGuest() 以访客身份登录 - 用于大规模使用或测试目的
  • 使用 authenticateWithToken() 通过你的账户或令牌登录 - 用于完整功能和无限消息

查找你的角色 ID

你可以在角色聊天页面的 URL 中找到角色 ID。

例如，如果你进入 Discord Moderator 角色的聊天页面，你会看到 URL https://beta.character.ai/chat?char=8_1NyR8w1dOXmI1uWaieQcd147hecbdIK7CeEAIrdJw。

URL 的最后一部分就是角色 ID: Character_ID

图像交互

警告: 这部分目前还在实验阶段，如果遇到任何问题，请提交 Issue。

🖼️ Character AI 具有在对话中生成和解释图像的能力。一些角色将这个概念融入特殊角色中，或者用它来识别图像，或者与角色互动并给予更多细节：可能性是无限的。

💁 大多数 Character AI 图像功能可以这样使用:

// 这些函数大多会返回图像的 URL
await chat.generateImage("dolphins swimming in green water");
await chat.uploadImage("https://www.example.com/image.jpg");
await chat.uploadImage("./photos/image.jpg");

// 其他支持的类型包括 Buffer、可读流、文件路径和 URL
await chat.uploadImage(imageBuffer);

// 包含图像的相对路径是上传图像所必需的
await chat.sendAndAwaitResponse({
  text: "What is in this image?",
  image_rel_path: "https://www.example.com/coffee.jpg",
  image_description: "This is coffee.",
  image_description_type: "HUMAN" // 如果你手动描述 AI 正在看什么，请设置这个
}, true);

感谢 @creepycats 实现了大部分这些功能

故障排除

问题答案
❌ 令牌无效确保你的令牌确实有效，并且你复制了整个令牌(它非常长)，或者你没有更新包。
⚠️ 无法找到指定的 Chromium 路径在大多数系统上，puppeteer 会自动定位 Chromium。但在某些发行版上，需要手动指定路径。如果 node_characterai 无法在 Linux 上定位 Chromium (/usr/bin/chromium-browser)，就会出现这个警告，如果 puppeteer 无法自动定位它，就会报错。请参阅这里以获取解决方法。
😮 为什么会打开 Chromium 进程?这是因为目前简单的获取方式已经失效，我使用 puppeteer (一个 Chromium 浏览器控制库)来绕过 Cloudflare 的限制。
👥 authenticateAsGuest() 不起作用请参阅 issue #14。
🦒 达到最大消息数量?遗憾的是，访客账户在被限制并强制登录之前只能发送有限数量的消息。请参阅下文了解更多信息 👇
🪐 如何使用一个账号来大规模使用该库？你可以使用对话功能，这是在1.0.0版本中引入的，可以分配给用户和频道。要重现一个对话，请使用OOC（角色外）让AI认为你在与多人交谈。 这里有一个例子： chrome_RDbmXXtFNlchrome_BgF8crPvqC （免责声明：对某些角色来说，他们的性格会使他们忽略任何OOC请求）。
🏃 如何在同时使用多个请求时避免并发和崩溃？查看@SeoulSKY 在这里使用async-mutex找到的解决方案。
📣 这是官方的吗？不，这个项目是由网站的一个粉丝制作的，是非官方的。要支持开发者，请查看他们的网站。
😲 用node_characterai做了什么很棒的事情？请让我知道！
✉️ 想联系我？查看我的个人资料
☕ 想支持我？你可以在ko-fi上给我买杯咖啡：https://ko-fi.com/coloride。非常感谢！
💡 有想法？在问题标签中提出问题
➕ 其他问题？在问题标签中提出问题

深入故障排除

🤚 在你往下滚动之前，请知道：

  • 在Client类中，你可以访问Requester类并定义puppeteer或其他与CharacterAI工作方式相关的变量，使用characterAI.requester.(属性)。另外，这里的任何内容都可能发生变化，所以请确保经常更新包。

💳 关于CharacterAI+

"我是cai+的会员，如何使用它？"

更改请求者的.usePlus属性，如果需要，还可以更改.forceWaitingRoom。

例如：

// 默认为`false`
characterAI.requester.usePlus = true;

🧭 关于Puppeteer

几个月前，该包只需要node-fetch模块就能运行。该包是使用简单的API请求制作的。

然而，随着时间的推移，Cloudflare开始对抗爬虫和机器人，这也使得几乎任何人都无法使用这个包。

这就是为什么在1.1及更高版本中，使用了puppeteer（它使用chromium浏览器）来进行API请求。

⚙️ 如何更改Puppeteer设置

👉 重要：在初始化客户端之前进行更改！

在CharacterAI类中，你可以访问请求者并定义.puppeteerPath变量或其他参数，属性包括*（且在未来版本中可能会发生变化）*：

// Chromium可执行文件路径（在某些linux发行版中为/usr/bin/chromium-browser）
puppeteerPath;
// 浏览器启动时的默认参数
puppeteerLaunchArgs;
// 表示默认超时的布尔值（默认为30000ms）
puppeteerNoDefaultTimeout;
// 表示默认协议超时的数字
puppeteerProtocolTimeout;
指定Chromium的路径

🐧 对于Linux用户，如果你的puppeteer没有自动检测到Chromium的路径，你需要手动指定它。

要做到这一点，你只需要将puppeteerPath设置为你的Chromium路径：

characterAI.puppeteerPath = "/path/to/chromium-browser";

在Linux上，你可以使用which命令找到Chromium的安装位置：

$ which chromium-browser # 或者你用来启动chrome的任何命令

💡 我建议你__经常__更新这个包以获取错误修复和新增功能。

免责声明

❤️ 这个项目经常更新，请始终检查最新版本以获取新功能或错误修复。

🚀 如果你有问题或想法，请在问题部分告诉我。

📜 如果你使用这个API，你也受他们网站使用条款的约束。

（real）coloride - 2023-2024，MIT许可。

相关项目
项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手，通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能，支持100+编程语言，与主流编辑器无缝集成，显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台，能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐，Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案，通过智能技术简化视频制作流程。无论是企业宣传还是个人分享，有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持，能够阅读和理解用户上传的文件内容，解析网页信息，并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题，Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术，为商家提供一键生成商品图和营销文案的服务，显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台，让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型，免费访问各种图像生成与AI训练工具，从Stable Diffusion等基础模型开始，轻松实现创新图像生成。体验前沿的AI技术，推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器，它将改变您观看视频的方式！SubCat结合了先进的人工智能技术，为您提供即时视频字幕翻译，无论是本地视频还是网络流媒体，让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台，利用前沿AI技术，为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图，再到文案生成，美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具，简化了选题、文献检索至论文撰写的整个过程。通过简单设定，平台可快速生成高质量论文大纲和全文，配合图表、参考文献等一应俱全，同时提供开题报告和答辩PPT等增值服务，保障数据安全，有效提升写作效率和论文质量。

使用协议隐私政策广告服务
投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号