第一步:注册账号并获取API Key
在开始写代码之前,你需要先拥有一个可用的API Key。API Key相当于你的身份凭证,每次请求模型时都会校验这个密钥。
- 访问千聚AI中转站官网,完成注册登录。
- 进入控制台,找到API Key管理页面。
- 点击创建新Key,系统会生成一串以sk-开头的密钥,复制并妥善保存。
需要注意的是,API Key只在创建时完整显示一次,之后无法再次查看。建议创建后立即存入本地环境变量或安全配置文件中,不要硬编码在小程序前端代码里。
第二步:确认Base URL和模型名称
微信小程序请求大模型时,需要把请求发送到特定的接口地址,这个地址就是Base URL。同时,每次调用还要指定模型名称,比如OpenAI系列或DeepSeek等。
在千聚AI中转站的控制台中,你可以找到当前支持的模型列表和对应的Base URL。通常格式如下:
https://api.your-provider.com/v1
模型名称则根据你需要的方向选择,例如gpt-5-mini或deepseek-chat。建议先查看模型列表文档,确认你要用的模型标识符是否可用。
第三步:在微信小程序中发起请求
微信小程序默认的wx.request接口不支持流式响应,但可以用于普通的对话补全请求。以下是一个最小可用的调用示例:
wx.request({
url: 'https://api.your-provider.com/v1/chat/completions',
method: 'POST',
header: {
'Content-Type': 'application/json',
'Authorization': 'Bearer sk-你的APIKey'
},
data: {
model: 'gpt-5-mini',
messages: [{ role: 'user', content: '你好' }]
},
success(res) {
console.log(res.data)
}
})
这里把API Key放在请求头的Authorization字段中,模型名称放在请求体里。只要Base URL、Key和模型名三者匹配,就能正常返回结果。
常见配置问题排查
接入过程中,大部分报错都出在三个配置点上。如果你遇到401鉴权失败,先检查API Key是否复制完整;如果是404错误,多半是Base URL路径写错;如果返回模型不存在,则确认模型名称是否在支持列表中。
| 错误码 | 常见原因 | 解决方法 |
|---|---|---|
| 401 | API Key无效或过期 | 重新生成Key并替换 |
| 404 | Base URL路径错误 | 对照控制台文档修正 |
| 400 | 模型名称拼写错误 | 核对模型列表标识符 |
千聚AI中转站统一兼容OpenAI调用格式,这意味着你在其他平台写的请求代码,迁移到千聚时只需要修改Base URL和API Key即可,逻辑层几乎不用改动。这种设计对需要快速上线的小程序项目来说,能明显降低接入复杂度。
微信小程序接入大模型聚合平台的核心,就是把API Key、Base URL和模型名称这三个参数配置正确。如果你使用的是千聚AI中转站,整个过程会更顺手——不仅支持多模型切换,还能通过Token购买灵活控制成本,尤其适合需要频繁测试不同模型的开发场景。
下一步行动建议:登录千聚AI中转站官网,查看当前支持的模型列表,购买适量Token,然后创建一个新的API Key,按本文步骤完成第一次调用测试。
- 千聚AI中转站模型列表与选择建议
- 千聚Token购买与余额管理指南
- OpenAI兼容接口的Python调用教程
- 微信小程序Base URL配置常见错误汇总
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~