Node_CharacterAI：非官方的Character AI Node.js封装库

Node_CharacterAI：与人工智能角色对话的强大工具

在人工智能快速发展的今天,与AI进行自然对话已经成为现实。Character AI作为一个让AI角色"活"起来的平台,吸引了众多用户的关注。而Node_CharacterAI则是一个让开发者能够轻松地在Node.js项目中与Character AI交互的非官方API封装库。本文将深入介绍这个库的特点、使用方法以及一些实用技巧。

🌟 项目简介

Node_CharacterAI是由GitHub用户realcoloride开发的一个开源项目,旨在为Node.js开发者提供一个简单易用的Character AI API封装。这个项目受到了RichardDorian之前开发的非官方Node API的启发,但在易用性和稳定性方面进行了显著改进。

项目地址：https://github.com/realcoloride/node_characterai

💡 主要特性

1. 完全使用JavaScript和CommonJS编写,确保最大兼容性和易用性
2. 支持异步请求
3. 可以使用对话功能或API来获取信息
4. 简单易用的接口设计
5. 持续活跃的开发
6. 支持访客和令牌登录

🛠️ 安装和基本使用

要开始使用Node_CharacterAI,首先需要通过npm安装:

npm install node_characterai

安装完成后,可以通过以下代码进行基本的访客认证和消息发送:

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

(async () => {
  // 以访客身份认证
  await characterAI.authenticateAsGuest();

  // 设置你要交互的角色ID
  const characterId = "8_1NyR8w1dOXmI1uWaieQcd147hecbdIK7CeEAIrdJw";

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

  // 发送消息并等待回复
  const response = await chat.sendAndAwaitResponse("你好,AI朋友!", true);

  console.log(response);
})();

🔐 使用访问令牌

对于需要更多功能或无限制消息的用户,可以使用Character AI账户的访问令牌进行认证。获取访问令牌的步骤如下:

1. 打开Character AI网站并登录
2. 打开开发者工具(F12)
3. 进入"应用"标签页
4. 在"存储"部分点击"本地存储"
5. 查找"char_token"键
6. 打开对象,右键点击值并复制你的会话令牌

获取令牌后,可以使用以下代码进行认证:

await characterAI.authenticateWithToken("你的访问令牌");

🖼️ 图像交互功能

Node_CharacterAI还支持与Character AI的图像生成和解释功能进行交互。以下是一些常用的图像相关功能:

// 生成图像
await chat.generateImage("海豚在绿色的水中游泳");

// 上传图像
await chat.uploadImage("https://example.com/image.jpg");
await chat.uploadImage("./photos/image.jpg");

// 发送带图像的消息
await chat.sendAndAwaitResponse({
  text: "这张图片里有什么?",
  image_rel_path: "https://example.com/coffee.jpg",
  image_description: "这是一杯咖啡。",
  image_description_type: "HUMAN"
}, true);

⚠️ 常见问题及解决方案

在使用Node_CharacterAI时,可能会遇到一些常见问题。以下是一些问题及其解决方案:

1. 令牌无效: 确保复制了完整的令牌,并检查包是否已更新到最新版本。

2. 找不到指定的Chromium路径: 在某些Linux发行版中,可能需要手动指定Chromium路径。可以通过设置characterAI.puppeteerPath来解决。

3. 为什么会打开Chromium进程?: 这是因为当前版本使用Puppeteer来绕过Cloudflare的限制。

4. 访客认证不工作: 这是一个已知问题,可以查看GitHub上的issue #14。

5. 达到最大消息数限制: 访客账户的消息数是有限的,建议使用账户令牌登录。

6. 如何避免并发请求导致的崩溃?: 可以使用async-mutex库来解决并发问题。

🚀 高级使用技巧

1. 使用CharacterAI+: 如果你是CharacterAI+会员,可以通过设置characterAI.requester.usePlus = true来启用相关功能。

2. 自定义Puppeteer设置: 可以在初始化客户端之前,通过characterAI.requester对象来自定义Puppeteer的各种设置,如执行路径、启动参数等。

3. 使用对话功能: 从1.0.0版本开始,Node_CharacterAI引入了对话功能,可以更好地模拟多人对话场景。

📌 注意事项

• 本项目不是官方项目,使用时需遵守Character AI的使用条款。
• 经常检查并更新到最新版本,以获得bug修复和新功能。
• 如果遇到问题或有新想法,可以在GitHub的Issues区反馈。
• 不要将你的会话令牌分享给不信任的人,以保护你的账户安全。

🎁 支持项目

如果你觉得Node_CharacterAI对你有帮助,可以通过以下方式支持项目:

1. 在GitHub上给项目加星⭐
2. 向作者捐赠咖啡
3. 为项目贡献代码或文档

结语

Node_CharacterAI为Node.js开发者提供了一个强大而灵活的工具,让与Character AI交互变得简单易行。无论你是想开发聊天机器人、AI助手还是其他创新应用,Node_CharacterAI都能为你的项目提供有力支持。随着AI技术的不断发展,我们期待看到更多基于Character AI的创新应用涌现。

通过Node_CharacterAI,让我们一起探索AI对话的无限可能吧!