飞书接入中转站的第一步:获取API Key
无论你使用飞书机器人还是飞书多维表格的AI功能,接入外部模型的第一步都是申请一个API Key。以千聚AI中转站为例,你需要在平台注册账号后,在控制台创建新的API Key。这个Key是飞书与中转站之间的身份凭证,请妥善保管。
在千聚后台,你可以管理多个Key,分别用于不同场景,例如开发环境与生产环境隔离。这比直接使用官方Key更便于统一管理,也适合团队协作时的权限控制。
配置Base URL:让飞书找到中转站
飞书内置的AI功能默认指向官方API地址,但接入中转站时需要修改Base URL。以千聚为例,其Base URL格式为:https://api.token88.cc/v1。在飞书机器人或多维表格的AI配置中,将默认地址替换为这个地址,飞书就能将请求路由到千聚的中转服务。
一个常见的错误是忘记在URL末尾加上“/v1”路径,或者误用了非OpenAI兼容格式。千聚完全兼容OpenAI接口规范,所以大多数飞书AI功能只需修改Base URL即可适配。如果你不确定自己的配置是否正确,可以访问 千聚AI中转站官网 查看最新的Base URL说明。
选择模型名称:在飞书中切换到不同大模型
配置好Key和URL后,最后一步是填写模型名称。千聚支持多模型聚合,包括OpenAI的GPT-5系列、Claude、Gemini、DeepSeek、Qwen等。在飞书AI配置中,你只需在“模型名称”字段填写对应的模型标识,例如“gpt-4o”或“claude-3-5-sonnet”,即可完成切换。
这意味着你无需在飞书和多个模型平台之间反复切换,只需通过千聚一个入口,就能调用不同模型。以下是常见模型在千聚中的标识对照:
| 模型系列 | 千聚中可用的模型名称(示例) | 适用场景 |
|---|---|---|
| GPT-5系列 | gpt-5, gpt-4o | 通用对话、代码生成 |
| Claude | claude-3-5-sonnet | 长文本分析、内容创作 |
| DeepSeek | deepseek-chat | 推理任务、中文优化 |
| Gemini | gemini-1.5-pro | 多模态理解 |
实际可用的模型列表以千聚官网实时展示为准,建议定期查看更新。
完整调用示例:飞书+千聚AI中转站
下面是一个简化版的Python代码示例,展示了如何在飞书机器人中通过千聚调用AI模型:
import openai
openai.api_key = "你的千聚API Key"
openai.base_url = "https://api.token88.cc/v1"
response = openai.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)
将这段代码集成到飞书机器人的Webhook逻辑中,即可实现飞书消息与AI模型的联动。如果你使用Node.js,只需将baseURL设置为相同的地址即可。
常见问题与排查思路
如果你在飞书接入后遇到502错误或请求超时,请按以下顺序检查:
- API Key是否已正确复制,没有多余空格。
- Base URL是否包含“/v1”路径,且协议为https。
- 模型名称是否与千聚平台提供的名称完全一致。
- 账户余额是否充足,可前往千聚后台查看Token余额。
以上步骤都确认无误后,飞书与中转站的连接通常可以正常工作。如果仍有问题,可以访问 立即访问千聚 查看最新文档或联系客服。
下一步行动:现在就前往千聚官网注册账号,获取你的API Key,并查看最新的模型列表和Base URL配置方式。完成配置后,在飞书中测试一次调用,体验多模型聚合的便捷性。
- 千聚AI中转站官网
- 查看模型列表
- www.token88.cc
- 购买Token
- OpenAI兼容接口教程
- 了解Python/Node.js调用方法
- API Key获取与管理
- 学习如何创建多场景Key