确认客服系统的API Key与千聚账号绑定
在正式开始对接前,首先要确保你在千聚AI中转站官网上已经注册账号并生成了可用的API Key。客服系统通常要求填写一个API密钥用于身份验证,千聚提供的API Key与OpenAI格式完全兼容,可以直接填入客服系统的“API Key”字段。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
注意细节:
- 不要复制错API Key的前后缀空格,避免鉴权失败。
- 每一步操作后,先通过千聚控制台的“测试调用”验证Key有效性。
- 不同客服系统对API Key的字段命名可能不一样(如“Secret Key”“API Token”),但本质相同。
Base URL配置不可遗漏斜杠
客服系统接入模型中转站时,Base URL是高频踩坑点。千聚的接口地址兼容OpenAI调用格式,但很多客服系统在填写“接口地址”或“Base URL”时,容易漏掉末尾的斜杠或路径层级。
推荐填写方式示例:
https://api.token88.cc/v1
需要确认的细节:
- 是否必须以
/v1结尾?大多数客服系统遵循OpenAI规范,需要保留/v1路径。 - 是否支持http和https混用?建议统一使用https。
- 部分老旧客服系统可能要求不带
/v1,此时需要咨询千聚技术支持确认路由规则。
模型名称必须与千聚平台保持一致
客服系统中填写的“模型名称”需要与千聚AI中转站平台上的模型标识完全匹配,包括大小写和连字符。例如,若打算使用GPT-4系列模型,应填写gpt-4或gpt-4-turbo,而不是自行缩写或添加版本号。
常用模型名对照表(部分示例)
| 模型系列 | 推荐填写的模型名 |
|---|---|
| OpenAI GPT-4系列 | gpt-4 / gpt-4-turbo |
| Claude系列 | claude-3-opus / claude-3-sonnet |
| DeepSeek系列 | deepseek-chat |
| Qwen系列 | qwen-plus / qwen-turbo |
完整模型列表请访问 立即访问千聚 查看最新支持情况。
确认Token余额与用量监控
客服系统上线后是持续消耗Token的,因此在接入前最好确认好余额管理方式。千聚支持按量使用,您可以在控制台实时查看余额和调用量。建议在客服系统后台设置每日用量上限或告警阈值,避免超支影响业务。
配置前检查清单:
- 是否已购买至少一次Token?购买后账户才有调用额度。
- 客服系统是否支持设置最大Token输出长度(max_tokens)?建议根据对话场景适当调整。
- 是否有备用模型可供切换?万一主模型临时不可用,可快速切换到备用模型保持客服在线。
下一步行动:
配置完成后,建议在客服系统中发送一条测试消息,确认能够正常回复。如果遇到任何错误,优先检查API Key、Base URL和模型名三个字段是否完全正确。欢迎前往 千聚AI中转站官网 查看完整模型列表、购买Token并获取专属API Key,快速启动您的智能客服方案。