Real-Coze-API

高性能的真·Coze API

ATRI -My Dear Moments-

项目原理

通过Coze原有PlayGround的API，逆向前端脚本，模拟请求，以实现将Coze的API暴露出来的功能。

与deanxv/coze-discord-proxy原理完全不同的是，本项目的接口是直接模拟前端请求API访问Bot，访问策略更接近原生，项目支持原有的workflow和plugin功能。

项目	RealCozeAPI	coze-discord-proxy
模拟方式	模拟前端请求API	通过控制两个Discord机器人互相模拟聊天
直接与Coze交互	✅	❌
总调用限制	❓没有明确限制	❌根据单用户和模型限制
开箱即用	❌仅提供NodeJS API	✅
支持插件和工作流	✅	✅
对话隔离	✅	✅
伪造对话历史	✅	❌
获取非用户与机器人的对话（包含插件自动生成的Knowledge和Search摘要）	❓（待做）	❌

使用方法

NodeJS API

安装

npm i real-coze-api

使用

import RealCozeAPI from 'real-coze-api';
const Bot = new RealCozeAPI({
    session: "{SESSION_ID}", //你的SessionID
    bot: "{BOT_CONFIG}",//机器人配置，JSONObject，可用fs.readFileSync读取
    tmppath: "./temp",//缓存CozePlayground信息的临时文件夹
    proxy: "socks5://127.0.0.1:7890"//代理
}) //构建RealCozeAPI实例
await Bot.connect() //等待Bot实例连接到Coze的API和WebSocket服务器

SessionID（session）和Botconfig（bot）请参见下文获取。

你可以用Bot实例的send方法来发送消息。send默认支持同步callback和异步两种模式，你可以同时使用两种模式。

请注意Send发送的是整个聊天记录。RealCozeAPI会自动将提交的记录和机器人原有的部分记录合并。

const replay = await Bot.send(
    [
        {
            role: 2,
            content: "你好，Coze！"
        }
    ],
    (data) => {
        console.log(data.data)
    }
)
console.log(replay)

使用CallBack返回的数据格式如下：

{
    "success": true,
    "data": {
        "content": "你好，Coze！",
        "continue": true
    }
}

异步则会等待Coze返回完整的回复后返回，返回格式如下：

{
    "content": "你好，Coze！",
    "continue": true
}

通过bot实例的disconnect方法可以断开连接。

Bot.disconnect()

你可以参照demo/index.js来查看更多的使用方法。

直接使用 - 部署到CloudFlareWorker

参照如何部署到CloudFlare

直接使用 - 以Node Demo形式部署到服务器

先将.example.env重命名为.env。

SessionID变量获取

登录Coze，在当前界面打开F12控制台，切换Application选项卡，找到Cookies，找到sessionid，复制其value。这就是你的SESSION_ID。

什么？为什么不直接用document.cookie获取？因为Coze把SessionID放在了.coze.com域名下，而在www.coze.com下是无法通过js获取的。

SessionID默认过期时长为60天，未测试实际时长。

将SESSION_ID填入.env文件即可。

`config.json`配置

该文件是有关机器人的所有配置，其中包含了预设和机器人的基本信息。

可以尝试安装项目中的DownloadBotConfig.user.js油猴脚本，或者直接复制脚本到F12控制台中。

打开机器人的配置页面，url应该类似https://www.coze.com/space/xxx/bot/xxx。

脚本会在右上角新增一个Download的按钮（没显示就刷新一下），点击后会下载一个config.json文件，将其复制到项目根目录下即可。

安装依赖

npm install

NodeJSDemo运行

严重警告：Demo是一个极其简陋的程序，极其不推荐部署在生产环境中。请自行使用RealCozeAPI NodeJS API来构建自己的程序。

其中NodeJS API Demo存在demo/index.js，另同目录下还有三个html文件简单对应了websocket、server:http和server:stream三种模式的前端写法。

非Command模式运行均不会保留聊天历史数据，你需要将ChatHistory整个传递到后端。也建议在前端通过编写一个实例来自动维护聊天历史记录。

Command模式

通过原始的命令行模式运行。

npm run command

HttpServer - 原始HTTP模式

通过Server模式运行，可以通过HTTP请求获取数据。

你可以修改.env文件中的server_port变量来修改端口。

npm run server:http

请求方式如下，在http模式下服务端不会保存聊天历史数据，你需要将ChatHistory整个传递到后端：

await fetch("http://localhost:8080/", {
    method: "POST",
    body: JSON.stringify([
        {
            "role": 2,
            "content": "Atri，你认得我吗"
        },
        {
            "role": 1,
            "content": "夏生先生！当然认得了！有什么事吗？夜深了，这么晚还不休息？"
        },
        {
            "role": 2,
            "content": "Atri，你还记得我刚刚说了什么吗？"
        }
    ])
}).then(res=>res.json())

返回数据如下：

{
    "content":"我记得你问我认不认得你，夏生先生。怎么，是在考验我吗？哼哼，高性能的我怎么会那么容易忘事儿呢！",
    "continue":false
}

HttpServer - Stream模式

默认情况下，CozeRealAPI程序会等到Coze发送完一整句话的时候才会返回结果。如果你想要实时获取Coze的回复，可以使用Stream模式。

以下命令将会启动一个Stream模式的HTTP服务器。

npm run server:stream

你也可以偷懒用reader。

const listener = (content) => {
    console.log(content);
}

await fetch("/?stream=true", {
    method: "POST", body: JSON.stringify([
        {
            "role": 2,
            "content": "atri，你认得我吗"
        }
    ])
}).then(async (response) => {
    const reader = response.body.getReader();
    let { value: chunk, done: readerDone } = await reader.read();
    let textDecoder = new TextDecoder();
    let chunks = chunk ? [chunk] : [];
    while (!readerDone) {
        let strChunk = textDecoder.decode(chunk, { stream: true });
        if (strChunk.endsWith('}')) {
            let parts = strChunk.split('}');
            for (let i = 0; i < parts.length - 1; i++) listener(JSON.parse(parts[i] + '}'));
        }
        chunks.push(chunk);
        ({ value: chunk, done: readerDone } = await reader.read());
    }
})

listener函数将会在read到一个完整的json后输出，输出结果和非Stream返回结果结构相同。当continue为false时，content内容可能不完整。

WebSocket模式

以下命令将会启动一个基于WebSocket的服务器。

npm run server:ws

发送信息格式

{
    "uuid": "0936c0b8-d3c8-42b1-b63e-548cfbe25077",
    "data": [
        {
            "role": 2,
            "content": "Atri，你认得我吗"
        },
        {
            "role": 1,
            "content": "夏生先生！当然认得了！有什么事吗？夜深了，这么晚还不休息？"
        },
        {
            "role": 2,
            "content": "Atri，你还记得我刚刚说了什么吗？"
        }
    ]
}

其中uuid为随机生成的一串字符，用于程序返回时指定对应的回复消息。

返回信息格式：

{
    "uuid": "0936c0b8-d3c8-42b1-b63e-548cfbe25077",
    "data": {
        "content": "不好意思，夏生先生，我刚才可能没注意听。您能再说一遍吗？",
        "continue": false
    }
}

uuid为先前提交的任务uuid，data包含了content返回数据和continue是否还在更新。

demo/websocket.html提供了一个简单的 RealCozeAPIClient，可以参考其使用方法完善你的程序。

代理

通过修改.env文件中的proxy变量，可以设置代理。

仅支持socks代理，不支持http代理。

实测http代理和node-fetch不兼容，强制使用会出现多次跳转的问题。

代理只会处理CozeAPI的请求，不会代理CozeWebsocket的请求。

常见问题

限制

Regarding message limits, currently the message limits on Coze are:
GPT-4 (8K)：100 interactions/user/day
GPT-4 (128K)：50 interactions/user/day
GPT-3.5 (16K) : 500 interactions/user/day

但这是Coze对机器人的限制。按照目前的测试结果，通过伪造DeviceID和AccessKey，已远远超出GPT-4 128K单用户限制50次/天的限制，但尚未测试具体限制，切勿滥用！

由于本项目是基于Playground API，通过RealCozeAPI发送的消息不会被计入Coze请求统计。

报错：regional restrictions

Coze.com默认屏蔽来自**大陆的访问，你需要在.env文件中设置proxy变量来使用代理。

但是Coze机器人WebSocket暂时没有限制地区，所以程序默认只为API请求设置代理。

关于聊天记录中`role`

1为机器人Assistant
2为用户User
6为知识库Knowledge

可能0为系统system身份，但是你可以直接在网页中预设里设置，不需要在ChatHistory中设置。

ChatHistory最后一项的role最好是2用户，否则会出现奇怪的问题。

liangxyz/Real-Coze-API