用渊站 Key 配置 AstrBot

渊站本身就是一套 NewAPI。AstrBot 官方专门写了 NewAPI 的接入方式，这里按它的步骤来，只把地址换成渊站。

一、先在渊站拿一把 Key

进渊站 → API 密钥 → 添加令牌 → 复制 sk- 开头的那串。

分组选不选都行

不选就是跟随你的账号等级，最省心。等确认能用了再考虑要不要指定分组。

二、在 AstrBot 里加提供商

打开 AstrBot 管理面板：

「模型提供商」→「对话」→「新增」

NewAPI 同时支持两种协议，选哪个：

选项	什么时候选
OpenAI Compatible	默认选这个，兼容性最好
OpenAI Responses	想用 Responses 接口时

弹出的对话框里填：

字段	填什么
提供商名称	随意，比如「渊站」
API Key	sk-你的渊站密钥
API Base URL	https://api.syuan.org/v1

这个地址要带 /v1

AstrBot 的 OpenAI Compatible 类型必须带 /v1。

填成 https://api.syuan.org 会一直 404。

三、获取并启用模型

点 「保存并获取模型」，AstrBot 会去拉渊站 GET /v1/models 的列表。

在列表里找到要用的模型，点右侧的 + 确认启用。

拉不到列表怎么办

先 「保存配置」，再点 「自定义模型」，手动填模型 ID。

渊站常见的：deepseek-v4.1-flash、gemini-3.8-flash、gpt-5.5

加完可以点模型旁的 「测试模型」 验证连通性——这一步能省掉后面很多来回。

四、应用到对话

光加了模型还不够，要设为默认，不然机器人不会用它。

「配置文件」→ 选择配置文件 →「AI」→「模型」→ 把「对话模型」设成刚加的模型 → 右下角「保存配置」

这一步最容易漏

很多人配完模型发现"不回消息"，八成是因为没做这一步。模型加了，但对话模型还是空的。

五、用 Gemini 原生接口（可选）

想保留 Gemini 的 thinkingConfig、safetySettings 之类参数，选 Google GenAI 类型：

字段	填什么
API Base URL	https://api.syuan.org ← 不带 /v1
API Key	你的渊站密钥
模型	gemini-3.8-flash

两种类型写法不一样

• OpenAI Compatible → Base 带 /v1
• Google GenAI → Base 不带 /v1

配错这一处会得到 404 或者 no available channel。

六、语音和生图

能力	渊站接口	模型
语音朗读	/v1/tts（原生格式）	drama-3、s2.1-pro
生图	/v1/images/generations	gpt-image-2.5

语音别用 /v1/audio/speech

FishAudio 只认 /v1/tts。用错会报 convert_request_failed。

详见 FishAudio 语音。

七、陪伴插件是另一套

如果你装的是陪伴插件（astrbot_plugin_private_companion），它有自己的「模型与连接」页面，和 AstrBot 主配置分开：

配在哪	管什么
AstrBot「模型提供商」	普通聊天回复
插件「模型与连接」	后台任务（主动消息、日程、状态、反思）

两边都要配。插件那边选同一个渊站提供商就行。

• 插件仓库：github.com/menglimi/astrbot_plugin_private_companion
• 插件 wiki：vue.syuan.org

配完不回消息？

按顺序查：

1. 对话模型设了吗 ← 最常见
2. Key 有没有额度（余额怎么查）
3. 令牌分组账号里有没有（报错怎么读）
4. 超时是不是太短（陪伴场景建议 120 秒以上）

还是不行就把错误信息和 request id 发给管理员，见排障指南。