言栖新手指南：API Key 怎么填、接口地址怎么配

这篇教程把从注册到发出第一条消息的完整流程写清楚，并列出最容易卡住的几个问题（401、404、跨域、超时）分别是什么原因、怎么解决。

一、注册并登录

用手机或电脑浏览器打开 chat.a8q9.cn，注册账号后登录。首次进入会看到「还没有会话」的空状态，这是正常的，先按下面两步配置接口。

二、获取 API Key

言栖本身不绑定某一家模型，你用谁的接口就填谁的 Key。下面是常见服务商的控制台入口，进入后在「API Keys」或「密钥管理」里新建一个 Key 并复制：

三、填写接口地址与模型名

进入「我 → 接口设置」，需要填三项：

1. 接口地址：填到 /v1 为止，不要带后面的 /chat/completions。
2. API Key：粘贴第二步复制的密钥。
3. 模型名：按服务商文档填写，例如 deepseek-chat。

常见写法示例：

DeepSeek   https://api.deepseek.com/v1
OpenAI     https://api.openai.com/v1
智谱       https://open.bigmodel.cn/api/paas/v4
硅基流动   https://api.siliconflow.cn/v1

填完可以发一条「你好」测试。能正常回复就说明配置成功，接下来在「通讯录」新建角色并绑定这个模型即可。

四、添加角色并开聊

1. 打开「通讯录」，点右上角加号新建角色，填写名称、人设，选择刚才配置的接口与模型。
2. 回到「微信」，点右上角加号选择角色，进入聊天窗口。
3. 长按消息可以引用回复；群聊里可以 @ 某个角色，让不同模型的角色同时参与。

每个角色可以绑定不同的接口与模型，所以可以同一时间用 DeepSeek 写代码、用 GPT 改文案，互不影响。

五、聊天记录与备份

会话、角色、接口配置默认保存在浏览器本地存储里。换手机、换浏览器或清理缓存前，请先在「我」里用「导出数据」保存一份文件，到新设备再导入恢复。清理浏览器数据是不可逆的。

六、常见报错对照

常见问题