准备工作
- 一个已在我们这里设置好、并使用付费方案(基础、普通、精英或企业)的网站。如果还没有,请用邮箱注册并输入您的网站地址。
- 一个 API 密钥:在后台打开 聊天软件与 API,给密钥起个名字(例如“AstrBot”),然后点 创建 API 密钥。请立即复制:它只显示这一次。
- 已运行并连接到聊天软件的 AstrBot(或其他工具)。如何安装 AstrBot 以及连接 Discord、Telegram、Slack、微信或 QQ,请看 AstrBot 自己的文档。
每个工具都会要求填写这三项:
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistant在 AstrBot 中设置
- 打开 AstrBot 管理面板,进入 模型提供商(Providers)。在 对话(Chat Completion)标签下,点 Provider Sources 旁边的 + 新增(Add)。
- 在 New model provider 中选择 OpenAI Compatible。
- 填一个您认得出的 ID,比如
7x24hrs。把密钥粘贴到 API Key,并把 API Base URL 设为https://7x24hrs.com/v1。 - 点 Save And Fetch Models。在 Available Models 下,点
7x24hrs-assistant旁边的 +。在弹出的窗口里,Model capabilities 下只保留勾选 Text(取消勾选 Image、Audio 和 Tool use:助手只回答文字),然后点 Save。 - 让机器人使用这个模型:在 配置文件(Config)里把它设为默认对话模型(也可以在 聊天(Chat)里用模型切换,只在某个对话中使用它)。
- 在 AstrBot 的 聊天(Chat)页面或已连接的聊天软件里问个问题。回答来自您网站的资料。
AstrBot 自带的人格和系统提示词请留空,或尽量写短:您的助手遵循您在 7x24hrs 后台设置的规则和角色,不会听从聊天软件系统提示词里的指令。
Dify、LobeChat 及其他工具
任何带有“OpenAI 兼容”或“自定义 OpenAI”提供商的工具,设置方法都一样:Base URL 填 https://7x24hrs.com/v1,再填您的 API 密钥和模型 7x24hrs-assistant。
- Dify:在 设置 → 模型供应商中添加 OpenAI-API-compatible,填写模型名称、您的密钥,并把 Base URL 填作 API 地址,然后在应用里使用这个模型。
- LobeChat:在设置的语言模型部分开启 OpenAI 提供商,填入密钥,把 API 代理地址设为 Base URL,再把
7x24hrs-assistant加入模型列表。 - 您自己的代码:用任意 OpenAI 客户端库调用 API,设置好 Base URL 和密钥即可。
在终端里试一下 API:
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'加上 "stream": true 后,回答会以服务器推送事件(SSE)的形式逐段返回,与 OpenAI 的方式相同:
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'在聊天软件里回答是怎样的
| 网站上的聊天按钮 | 通过 API 的聊天软件 | |
|---|---|---|
| 回答依据 | 您的网站资料、标准答案和角色 | 相同 |
| 没把握时 | 如实说明,并把访客转给您 | 如实说明,并在回答中给出您的联系地址 |
| 通知您 | 通过邮件、Slack、Discord 或 Telegram | 相同,标注“来自 API / AstrBot” |
| 亲自回复访客 | 在您的聊天软件或后台里 | 无法从这里回复:请用邮件回复 |
| 对话计数 | 每位访客每次对话算一次 | 相同,从同一份每月额度中扣除 |
哪些方案可以接入聊天软件?
所有付费方案:基础方案每月 $19 含 90 次对话,普通方案 $59 含 275 次,精英方案 $199 含 1,000 次,企业方案 $1,099 含 6,000 次。通过 API 的对话与聊天按钮共用同一份每月额度。免费版不包含聊天软件:在免费版上创建的密钥会暂停,直到您选择付费方案。详见价格。
怎样算一次对话?
一位访客的一次聊天,不论问了多少个问题,和聊天按钮完全一样。如果工具在每次请求中都带上 user 字段,我们就能区分不同访客;否则按对话的第一条消息来识别一次对话。
AstrBot 里的系统提示词能改变助手说的话吗?
不能。聊天软件发来的系统提示词不会被采纳。助手始终遵守您的规则:只依据您网站的资料作答,不知道就直说,不承诺您网站上没写的事。它的角色就是您在后台设置的那个。
支持图片、语音消息或工具调用吗?
暂不支持。只回答文字;消息里的图片和其他附件会被忽略,没有文字的消息会收到明确的错误提示。客户端发来的工具定义也会被忽略。
密钥泄露了怎么办?
在 聊天软件与 API 中吊销它:它会立即失效。然后创建一个新密钥,粘贴到您的工具里。密钥只以指纹形式保存,所以我们也无法再次显示某个密钥。