一、准备工作:注册千聚并获取API Key
在开始配置飞书之前,你需要先准备一个可用的API Key。以下是具体步骤:
- 访问 千聚AI中转站官网,完成账号注册。
- 登录后进入控制台,在“API Key管理”页面创建一个新的密钥。建议为飞书项目单独命名,方便后续管理。
- 复制生成的API Key并妥善保存,后续在飞书机器人配置中需要使用。
千聚支持GPT-5系列、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等主流模型,你可以在官网查看实时模型列表,选择适合自己业务场景的模型。
二、配置飞书机器人的Base URL和模型名称
在飞书开放平台创建应用,开启机器人能力后,你需要在后端代码中调用千聚的API。由于千聚提供兼容OpenAI的接口,配置方式与调用OpenAI官方API基本一致,只需要修改三个核心参数:
- API Key:填入第一步中从千聚获取的密钥。
- Base URL:设置为千聚提供的地址
https://www.qianjuai.cc/v1。 - 模型名称:根据实际需求选择,例如
gpt-4o、claude-3-opus或deepseek-chat。
以下是一个简短的Python代码示例,展示了如何在飞书机器人事件处理函数中调用千聚API:
import openaiopenai.api_key = "sk-你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
response = openai.ChatCompletion.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)
将这段代码嵌入到飞书机器人的消息处理逻辑中,即可实现飞书与千聚大模型聚合平台的对接。
三、测试调用与验证
完成配置后,建议在飞书机器人中发送一条测试消息,例如“介绍一下飞书接入大模型聚合平台的优势”。如果返回正常响应,则说明接入成功。如果遇到问题,可以按以下方向排查:
- API Key无效:检查是否复制完整,或在千聚控制台重新生成。
- Base URL错误:确保地址末尾包含
/v1/,且无拼写错误。 - 模型名称不支持:前往千聚官网查看当前支持的模型列表,确认模型名称是否准确。
千聚的接口设计兼容OpenAI SDK,多数主流编程语言(如Python、Node.js、Java)都可以直接调用,降低了接入复杂度。
四、Token购买与余额管理
千聚采用按量计费模式,你可以在控制台内随时购买Token,并查看余额消耗情况。对于飞书这类高频调用场景,建议根据预估使用量提前充值,避免因余额不足导致服务中断。所有模型共用同一个余额池,切换模型时无需额外结算,更便于统一管理。
此外,你还可以关注以下相关资源:
立即访问 千聚AI中转站官网,查看完整模型列表,购买Token并获取API Key,开始你的飞书AI接入测试吧!
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~