第一步:注册千聚账号并获取API Key
在开始配置之前,你需要先拥有一个可用的千聚账号。访问千聚官网完成注册并登录后,进入控制台找到“API Key管理”页面。点击创建新的API Key,系统会生成一串密钥字符串。请妥善保存这一串Key,后续在钉钉应用中配置时需要使用。
如果你还没有账号,可以立即访问 www.token88.cc 完成注册和信息查看。千聚支持多模型聚合调用,一个账号即可管理OpenAI、Claude、Gemini、DeepSeek、Qwen等主流模型,省去多平台切换的麻烦。
第二步:配置Base URL,对接钉钉应用
在钉钉自定义机器人或企业内部应用中调用AI模型,需要将请求地址指向千聚的API网关。不同模型可能对应不同的端点,但千聚统一使用OpenAI兼容格式,Base URL配置非常直观。
例如,在钉钉应用的后端代码中,你可以这样设置请求地址:
- API Key:填入第一步获取的千聚密钥
- Base URL:
https://api.token88.cc/v1 - 模型名称:根据实际需求填写,如
gpt-4o、claude-3-5-sonnet、deepseek-chat等
以下是一个简单的Python调用示例,展示如何在钉钉机器人中配置:
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)
注意:实际使用时请将 api_key 替换为你的真实密钥。千聚的Base URL完全兼容OpenAI的调用方式,如果你已有现成的OpenAI SDK代码,只需修改 base_url 和 api_key 即可快速接入。
第三步:模型切换与多模型管理
千聚的一个显著优势是支持多模型随意切换,不需要为每个模型单独申请API Key或配置不同的Base URL。你只需要在同一条请求中修改 model 参数的值,就能在GPT-5、Claude、Gemini、Grok、Kimi、豆包、GLM等模型之间灵活切换。
例如,在钉钉工作流中,你可以根据业务场景动态选择模型:
- 处理复杂逻辑时切换到
gpt-4o或claude-3-5-sonnet - 处理长文档时使用
gemini-1.5-pro - 日常对话或简单任务用
deepseek-chat或qwen-max
这种模式大大降低了接入复杂度,特别适合需要多模型调度的企业团队。你可以在千聚官网的模型列表页面查看当前支持的完整模型清单,实时了解可用性。
第四步:购买Token与余额管理
千聚采用按量计费模式,使用前需要购买Token并充值到账户。在控制台的“Token购买”页面,你可以选择适合的套餐进行充值。充值后,每次调用会实时扣减余额,你可以随时查看消耗明细和余额状态。
这种模式对于钉钉接入场景尤其友好。你不需要提前购买大量配额,用多少充多少,成本可控。同时,一个账户下的多个API Key可以共享余额,方便团队统一管理。
常见问题排查
如果在钉钉接入过程中遇到问题,可以从以下几个方面排查:
- API Key无效:检查是否复制了完整的密钥,注意不要包含多余空格
- Base URL拼写错误:确认地址以
https://api.token88.cc/v1结尾,不要遗漏末尾的/v1 - 模型名称不存在:前往千聚官网查看最新的模型列表,确保名称准确
- 余额不足:登录控制台检查Token余额,及时充值
如果以上步骤仍无法解决问题,建议访问千聚官网查看详细的API接入文档,或联系在线支持获取帮助。
下一步:开始测试你的第一次调用
读完这篇千聚AI中转站官网教程,你已经掌握了钉钉接入模型中转站的核心方法。现在就去注册账号、获取API Key,并按照上面的步骤配置Base URL和模型名称,进行一次简单的调用测试吧。一次成功的返回,意味着你的钉钉应用已经具备了多模型调用能力,后续可以在此基础上扩展更多智能场景。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~