一、为什么微信小程序需要模型中转站
微信小程序的前端环境对网络请求有诸多限制,直接调用海外大模型API不仅存在域名白名单问题,还面临响应延迟不稳定、模型切换成本高等痛点。通过一个兼容OpenAI接口的中转站,开发者只需配置统一的Base URL和API Key,即可在同一个平台上调用GPT、Claude、Gemini、DeepSeek、文心、通义千问等多个模型。这种方式更适合国内开发环境,能够显著降低接入复杂度。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
二、准备工作:注册与获取凭证
第一步是前往千聚AI中转站完成账号注册并获取API Key。访问 千聚AI中转站官网,注册账号后在控制台创建API Key。同时,你可以在模型列表页面查看当前支持的模型名称,例如gpt-4o、claude-3.5-sonnet、deepseek-chat等。购买适量Token后,你就可以在后续步骤中使用这些凭证了。
三、微信小程序中配置请求域名
在微信小程序的后台管理界面,找到“开发”下的“服务器域名”配置项。将千聚中转站的Base URL(例如 https://api.token88.cc)添加到“request合法域名”列表中。这一步骤是让小程序能够正常向中转站发送网络请求的前提。
四、代码接入示例
以下是一段在微信小程序中使用JavaScript发起AI模型调用的核心代码片段。你只需要替换其中的API Key和模型名称即可。
wx.request({
url: 'https://api.token88.cc/v1/chat/completions',
method: 'POST',
header: {
'Content-Type': 'application/json',
'Authorization': 'Bearer 你的API Key'
},
data: {
model: 'gpt-4o',
messages: [
{role: 'user', content: '你好,请介绍一下你自己'}
]
},
success: function(res) {
console.log(res.data.choices[0].message.content);
}
});
将你的千聚API Key填入代码中的Bearer字段,并根据需求调整model参数,即可完成一次模型调用。千聚支持几乎所有主流模型的名称格式,可在官网查阅完整的模型映射表。
五、常见问题与排查建议
| 问题现象 | 可能原因 | 解决建议 |
|---|---|---|
| 请求返回401错误 | API Key无效或未正确配置 | 重新获取Key并检查代码中的Authorization字段 |
| 请求返回404错误 | Base URL或模型名称错误 | 确认域名是否添加白名单,模型名称以官网为准 |
| 返回内容为空或超时 | Token余额不足或网络延迟 | 在千聚控制台检查余额,必要时更换备用模型 |
如果你在接入过程中遇到其他问题,也可以随时访问 立即访问千聚 查看最新的接入文档和常见问题解答。
六、下一步行动
现在你只需要完成三件事:前往千聚官网注册账号并购买Token,获取API Key,然后将上文中的代码直接复制到你的微信小程序项目中并替换关键参数,即可开始第一次模型调用。千聚提供统一的接口管理和多元化的模型选择,能够有效降低开发者的多模型接入成本,让你的微信小程序快速拥有AI能力。