准备工作:注册千聚账号并获取API Key
在开始配置微信小程序之前,你需要先拥有一个可用的API Key。推荐使用千聚AI中转站,因为它支持统一的OpenAI兼容接口,省去在多个平台来回切换的麻烦。具体步骤如下:
- 注册账号:访问 千聚AI中转站官网,完成注册并登录。
- 购买Token:在“Token购买”页面,选择合适的套餐进行充值。千聚支持按量使用,余额管理清晰,适合从小规模测试到正式上线的不同阶段。
- 获取API Key:登录后进入“API Key管理”页面,点击“创建新密钥”,系统会生成一串以“sk-”开头的密钥,请妥善保存。
这一步完成后,你就拥有了一个可以调用多种模型(包括OpenAI、Claude、DeepSeek、千问等)的API Key。
微信小程序中配置Base URL和模型名称
微信小程序通常使用HTTPS请求与后端通信。由于微信小程序的安全域名限制,你需要将Base URL配置为千聚提供的统一接入地址,并在请求中指定模型名称。以下是配置要点:
- Base URL(基础地址):千聚的API接口完全兼容OpenAI调用方式,Base URL格式为:
https://www.qianjuai.cc/v1。在微信开发者工具中,需要在“项目设置”->“域名”中,将上述地址添加到“request合法域名”列表中。 - API Key:将上一步获取的密钥,作为请求头中的
Authorization: Bearer sk-xxx。 - 模型名称:在请求体中的
model字段填写你需要的模型,例如gpt-4o、claude-sonnet-4-20250514、deepseek-chat等。完整的模型列表请前往千聚官网查看。
以下是一个简单的微信小程序JavaScript代码片段,展示如何发起一次模型调用:
wx.request({
url: 'https://www.qianjuai.cc/v1chat/completions',
method: 'POST',
header: {
'Content-Type': 'application/json',
'Authorization': 'Bearer sk-你的API密钥'
},
data: {
model: 'gpt-4o',
messages: [
{ role: 'user', content: '请用一句话介绍你自己' }
]
},
success: function(res) {
console.log(res.data.choices[0].message.content);
}
});
将上述代码中的sk-你的API密钥替换为真实密钥,即可在小程序内完成一次模型调用。
模型选择与多模型切换建议
千聚的一大优势是支持多模型聚合调用,覆盖GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等主流方向。对于微信小程序开发者来说,可以根据业务场景灵活切换模型:
| 场景 | 推荐模型方向 | 说明 |
|---|---|---|
| 智能客服 | GPT-4o、DeepSeek | 响应速度快,成本可控 |
| 内容生成 | Claude、Qwen | 长文本表现优秀 |
| 多模态识别 | GPT-4o、Gemini | 支持图片和语音输入 |
| 实时对话 | Kimi、豆包 | 延迟低,适合流式输出 |
在微信小程序中切换模型,只需修改请求体中的model字段值即可,无需调整其他配置。这种统一接口设计,大大降低了多平台切换的接入成本。
调试与常见问题排查
如果在配置过程中遇到问题,可以按以下顺序排查:
- 403或401错误:检查API Key是否填写正确,或密钥是否已过期。可以在千聚控制台重新生成密钥。
- 报错“域名不在合法列表中”:请确认已将
https://api.token88.cc添加到微信小程序后台的request合法域名。 - 模型返回为空或超时:可能是模型名称拼写错误,或者所选模型当前负载较高。建议前往 立即访问千聚 查看实时模型状态。
千聚提供了完善的余额管理和使用记录功能,方便你随时了解调用情况,控制成本。
下一步:开始你的第一次模型调用
现在你已经掌握了微信小程序接入大模型聚合平台的核心配置方法。接下来,建议你立即前往千聚官网,完成注册、获取API Key,并按照上述代码示例发起一次测试调用。如果一切顺利,你就可以在微信小程序中集成智能对话、内容生成等功能了。
立即行动:
- 千聚AI中转站官网 — 注册账号,获取API Key
- 查看完整模型列表,选择适合你项目的模型
- 购买Token,开始按量使用
- 阅读更详细的API接入教程,了解流式输出、函数调用等高级功能