第一步:获取千聚的API Key与Base URL
在飞书内调用大模型,你需要一个兼容OpenAI接口的中转站作为桥梁。千聚AI中转站(简称“千聚”)提供了统一的API接口,支持GPT-5、Claude、Gemini、DeepSeek等主流模型,无需分别对接多个平台。
配置前,请先完成以下准备:
- 前往 千聚AI中转站官网 注册账号并登录。
- 在控制台中创建一个API Key,并复制保存。
- 记下千聚的Base URL:通常格式为
https://api.token88.cc/v1(具体以官网最新文档为准)。
请务必确认你已成功获取API Key和Base URL,这是飞书接入模型中转站的核心凭证。
第二步:在飞书开放平台配置应用
登录飞书开放平台,创建或编辑你的机器人应用。在“事件与回调”或“权限管理”中,配置模型调用地址。关键参数如下:
| 配置项 | 千聚对应值 | 说明 |
|---|---|---|
| 请求地址(Base URL) | https://api.token88.cc/v1 |
替换飞书默认的请求地址 |
| 认证方式 | Bearer Token | 将API Key作为Token传入 |
| 模型名称 | gpt-4o 或 claude-3-opus 等 |
根据千聚模型列表选择 |
注意:飞书不同版本(如新版飞书机器人、自定义机器人)的配置入口略有差异,但核心都是在代码中设置好 Base URL 和 API Key。缺少任意一项,调用都会失败。
第三步:编写调用代码(示例)
以下是一个简化的Python示例,展示如何在飞书后端代码中配置千聚的API信息:
import openai
openai.api_key = "sk-千聚提供的API Key"
openai.base_url = "https://api.token88.cc/v1/"
model_name = "gpt-4o"
将这段配置放在飞书事件处理逻辑中,即可让飞书机器人通过千聚调用大模型。千聚的接口完全兼容OpenAI SDK,因此你无需修改调用逻辑,只需替换以上三个参数即可。
常见配置遗漏排查
如果飞书机器人无法正常响应,请对照以下清单逐一检查:
- Base URL末尾是否遗漏了
/v1:多数兼容接口需要该路径。 - API Key是否完整复制:注意前后无空格,且未过期。
- 模型名称是否在千聚模型列表中:进入官网查看最新模型列表。
- 网络环境是否允许访问千聚域名:确保服务器可正常请求
api.token88.cc。
配置完成后,你可以在飞书群聊中直接@机器人测试一条消息,确认模型是否正常返回结果。
立即开始接入
飞书接入模型中转站并不复杂,关键是准备好API Key和Base URL。如果你还没有获取这些信息,现在就可以访问 立即访问千聚 注册并创建API Key。千聚提供多种主流模型,支持按量购买Token,帮助你快速在飞书环境中落地AI能力。
接下来,你可以参考以下内容进一步深化配置:
- 模型列表与价格
- Token购买与余额管理指南
- API接入教程(Python/Node.js)
- OpenAI兼容接口配置详解