准备工作:注册千聚并获取凭证
在飞书中配置任何AI模型之前,需要先拥有一个千聚AI中转站账号。千聚提供统一的多模型接入入口,省去管理多个平台API的麻烦。访问 千聚AI中转站官网 完成注册,即可进入控制台。
注册成功后,在个人面板找到“API Key管理”区域。点击创建新的API Key,系统会生成一串密钥。注意:这一步生成的密钥是后续所有飞书调用凭证的核心,请妥善保存。如果后续想更换密钥,也可以在控制台随时重置。
飞书配置中的两大核心参数
飞书接入AI模型时,无论是使用飞书自带的AI功能,还是通过自定义接口调用,都离不开两个核心参数:Base URL和API Key。千聚AI中转站完全兼容OpenAI的接口规范,因此配置起来非常直观。
Base URL配置
飞书需要知道请求发往哪个地址。在千聚控制台的“接入文档”中,你可以找到专用Base URL。一般格式为:
https://api.token88.cc/v1
将这一段地址填入飞书的模型服务设置中,注意末尾的 /v1 不要遗漏。不同飞书版本或插件对Base URL的字段命名可能略有差异,但本质都是服务地址。
API Key配置
将上一节获取的API Key填入飞书对应的“API密钥”或“令牌”字段中。确保复制的字符串完整,不要包含多余的换行或空格。配置完成后,飞书与千聚之间的身份验证就通过了。
选择模型名称并测试调用
配置完Base URL和API Key后,还需要指定需要调用的模型名称。千聚AI中转站聚合了多种模型,例如GPT-4o、Claude-3、DeepSeek-V3等。在控制台的模型列表中可以查看完整的模型ID列表。
在飞书中,通常有一个“模型选择”或“模型名称”的设置项。直接填入千聚平台上的模型ID即可。比如要调用GPT-4o,就填入 gpt-4o。保存配置后,建议立即执行一次简单的测试调用,例如让飞书生成一段文本或总结一条消息。如果能成功返回结果,说明丝滑接入已完成。
常见配置排查清单
如果在测试调用时遇到错误(如401认证失败、404端点错误等),可以参考以下排查方向:
- 检查API Key权限:确认密钥在千聚后台处于“启用”状态,且没有被误删除。
- 确认Base URL格式:检查是否漏了
https://协议头或末尾的/v1。 - 验证模型名称:确保模型ID与千聚平台上显示的名称完全一致,注意大小写。
- 账户余额:如果提示额度不足,前往千聚控制台购买Token或充值。
一次配置,多个模型复用
配置完成后,飞书接入千聚的优势就体现出来了:你无需为每个模型单独配置一套接口,只要在飞书的设置中修改模型名称字段,即可切换到不同大模型。这种模式对于团队来说,极大减少了维护成本,也避免了多平台API Key散落管理的风险。千聚作为中转站,让模型调用变得更集中、更丝滑。
下一步行动建议:
- 千聚官网
- 千聚模型列表与接入指南
- Token购买与余额管理教程
- OpenAI兼容接口配置详解
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~