配置前需要准备什么
在开始钉钉接入模型中转站教程之前，请先确保你已准备好以下三项基本资源：
- 千聚账号与API Key：前往千聚AI中转站官网注册并登录，在控制台创建API Key。这是进行模型调用的身份凭证。
- Base URL地址：千聚统一提供兼容OpenAI的Base URL，你无需为不同模型切换不同入口，只需配置一个地址即可。
- 目标模型名称：千聚聚合了GPT-5系列、Claude、Gemini、DeepSeek、Qwen、豆包、GLM等主流模型，你可以在官网模型列表中选择适合你业务场景的模型。
钉钉接入模型中转站的详细配置步骤
以下步骤将指导你如何在钉钉中完成模型中转站的配置，无论是开发钉钉机器人还是调用AI接口，均可参考此流程。
- 创建钉钉机器人或应用：在钉钉开放平台创建一个企业内部应用或机器人，获取AppKey、AppSecret以及消息接收URL。
- 配置千聚API Key：在应用后端代码中，将千聚API Key设置为环境变量或直接写入配置文件。代码示例如下：
export TIANJU_API_KEY="sk-your-key-here"
- 设置Base URL：在代码中指定千聚的Base URL地址，例如：
openai.api_base = "https://www.qianjuai.cc/v1"
- 选择模型并调用：在钉钉回调逻辑中，使用千聚API发送请求。以下是一个简单的Python调用示例：
response = openai.ChatCompletion.create(
model="gpt-4",
messages=[{"role": "user", "content": "你好"}],
api_key="sk-your-key-here"
)
- 返回结果并处理响应：将千聚返回的模型结果通过钉钉机器人消息接口回传给用户，完成一次完整的对话。
如何测试模型调用是否成功
完成配置后，建议使用curl命令或简单的Python脚本进行快速测试，避免在钉钉中反复调试。以下是一个curl测试示例：
curl https://www.qianjuai.cc/v1chat/completions
-H "Content-Type: application/json"
-H "Authorization: Bearer sk-your-key-here"
-d '{"model": "claude-3-sonnet", "messages": [{"role": "user", "content": "hello"}]}'
如果返回200状态码和正常JSON响应，说明你的Base URL和API Key配置正确，之后可以将相同逻辑集成到钉钉中。
常见问题与排查思路
| 问题现象 | 可能原因 | 解决建议 |
|---|---|---|
| 401认证失败 | API Key错误或过期 | 重新在千聚生成Key并替换 |
| 模型不可用 | 模型名称拼写错误或未开通 | 前往官网查看模型列表并确认名称 |
| 请求超时 | 网络环境或代理问题 | 检查网络连通性，可尝试更换国内节点 |
如果遇到其他问题，可以参考千聚的API接入教程或直接联系技术支持。
为什么选择千聚作为钉钉中转站
千聚AI中转站专为国内开发者设计，提供统一兼容OpenAI的接口，让你无需为不同模型单独适配。一次配置，即可调用包括GPT-5、Claude、Gemini、DeepSeek、豆包、Qwen、GLM等在内的多种主流模型，显著降低多平台切换的复杂度。同时，千聚支持按量购买Token，余额管理透明，适合开发团队快速迭代和成本控制。
如果你想进一步了解模型列表及Token购买方式，可以访问立即访问千聚查看最新信息。
下一步：开始接入
现在你已经掌握了钉钉接入模型中转站的核心配置方法。接下来，建议你完成以下操作：
- 前往千聚官网获取API Key并查看Base URL配置方式
- 在钉钉中创建一个测试机器人，使用上述步骤配置并发送第一条消息
- 根据实际业务需求，购买适量Token并开始正式调用
通过以上步骤，你可以在钉钉中快速完成模型接入，充分发挥千聚的多模型聚合优势。如需更详细的Python或Node.js调用示例，以及模型列表和套餐详情，请直接访问千聚官网。
- 千聚AI中转站官网
- 模型列表与Token购买
- API接入教程
- 获取详细调用示例与常见错误码说明
- OpenAI兼容接口文档
- 对接标准，快速迁移现有项目
- Base URL配置指南
- 一键切换，无需重复适配