第一步:准备千聚AI中转站账号与API Key
在开始配置之前,你需要先拥有一个可用的API Key。访问千聚AI中转站官网完成注册,进入后台管理面板,在“API Key管理”页面生成一个新的密钥。这个密钥是后续所有模型调用的身份凭证,请妥善保管。
注册完成后,你还可以在后台查看当前支持的模型列表,包括GPT-5系列、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等主流模型。千聚的平台采用统一接口设计,你只需一个API Key即可调用所有模型,无需为不同厂商单独申请密钥,大大降低了多平台切换的复杂度。
如果你还没有账号,现在就可以 立即访问千聚 完成注册并获取API Key。
第二步:配置Base URL与模型名称
千聚AI中转站兼容OpenAI的调用方式,因此在配置Base URL时,你只需要将原本的 https://api.openai.com 替换为千聚提供的统一接入地址。具体地址请登录后台在“接入文档”中查看,通常格式类似 https://www.qianjuai.cc/v1。
下面是一个简单的Python调用示例,展示了如何配置Base URL、API Key和模型名称:
import openai
openai.api_base = "https://www.qianjuai.cc/v1" # 千聚的Base URL
openai.api_key = "sk-你的千聚API Key" # 你在千聚后台生成的密钥
model = "gpt-4o" # 选择的模型名称
response = openai.ChatCompletion.create(
model=model,
messages=[{"role": "user", "content": "你好,请用中文回复。"}]
)
print(response.choices[0].message.content)
注意,模型名称需要与千聚平台后台“模型列表”中展示的名称完全一致。如果你不确定当前可用的模型名称,可以登录后台直接查看。
钉钉接入模型中转站方案的核心就是这三步配置:API Key、Base URL和模型名称。只要这三个参数正确,你就可以在钉钉机器人或企业内部应用中像调用OpenAI一样调用千聚聚合的多种模型。
第三步:在钉钉中集成并测试调用
获取到API Key并配好Base URL之后,就可以在钉钉应用中进行集成了。通常的做法是:
- 在钉钉开放平台创建一个企业内部应用,获取AppKey和AppSecret。
- 在应用的后端代码中,使用上述Python示例逻辑调用千聚的接口,将AI模型的回复返回给钉钉消息。
- 部署后端服务后,在钉钉内发送一条测试消息,验证模型是否正常响应。
如果测试时遇到连接失败或返回错误,请优先检查以下三个地方:
- Base URL末尾是否遗漏了
/v1路径。 - API Key是否复制完整,没有多余的空格或换行。
- 模型名称是否与千聚后台“模型列表”中的名称完全一致,注意大小写。
绝大多数配置问题都出在这三个参数上,逐一核对即可解决。
统一管理,降低接入成本
使用千聚AI中转站的最大好处是,你不需要为每个模型单独维护一套接入代码。无论是GPT-5系列还是Claude,无论是DeepSeek还是Qwen,你只需要修改代码中的 model 参数,其他配置保持不变。这种设计对于需要同时使用多个模型的团队来说,非常便于统一管理,也适合作为企业的备用方案,减少供应商锁定风险。
关于Token购买和余额管理,千聚后台提供了清晰的按量使用统计。你可以随时查看消耗情况,并根据需要充值。具体价格和套餐方案,请以官网实时信息为准。