第一步:注册千聚AI中转站并获取API Key
要接入模型中转站,首先需要一个账号和有效的API Key。打开 千聚AI中转站官网,完成注册并登录。进入“API Key管理”页面,点击创建新的API Key,系统会生成一串类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 的密钥。请妥善保存,因为后续每次请求都需携带这个Key进行身份验证。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
千聚的优势在于一个API Key即可调用多种主流模型(如GPT-5系列、Claude、DeepSeek、Gemini、Qwen等),无需为每个模型单独申请密钥,有效降低了微信小程序的多平台切换成本。
第二步:获取Base URL与选择模型名称
微信小程序请求的Base URL是接入千聚的关键。千聚采用完全兼容OpenAI接口的格式,你只需要将Base URL设置为千聚提供的统一入口。在千聚官网的“文档中心”可以看到具体的Base URL地址,通常形如 https://api.token88.cc/v1。模型名称则根据你需要使用的模型选择,例如 gpt-5-turbo 或 claude-3-opus,具体列表可在模型页面查看。
| 配置项 | 千聚示例值 | 说明 |
|---|---|---|
| Base URL | https://api.token88.cc/v1 | 统一入口,兼容OpenAI |
| API Key | sk-xxxxxxxxxxxxxxxx | 在千聚后台创建 |
| 模型名称 | gpt-5-turbo | 按需选择,支持数十种模型 |
注意:微信小程序要求请求的API域名必须在 request 合法域名中配置。你需要在微信小程序后台将千聚的Base URL域名(例如 api.token88.cc)添加到白名单,否则调用会被拦截。
第三步:在微信小程序中编写调用代码
以下是一个基于千聚API的微信小程序请求示例,仅演示核心配置(API Key、Base URL、模型名)。
wx.request({
url: 'https://api.token88.cc/v1/chat/completions',
method: 'POST',
header: {
'Content-Type': 'application/json',
'Authorization': 'Bearer sk-xxxxxxxxxxxxxxxx' // 替换为你的API Key
},
data: {
model: 'gpt-5-turbo', // 模型名称
messages: [
{ role: 'user', content: '你好,请介绍一下自己。' }
],
stream: false // 如需流式输出可设为true
},
success(res) {
console.log(res.data)
// 处理返回的AI回答
},
fail(err) {
console.error('请求失败', err)
}
})
将上述代码中的 sk-xxxxxxxxxxxxxxxx 替换为你在千聚获取的真实API Key,model 字段换成你需要的模型名,即可完成第一次调用。千聚的接口完全遵循OpenAI规范,因此你还可以直接使用现有的OpenAI SDK,只需修改Base URL和API Key,无需改动其他代码,非常适合快速移植。
常见问题与调试建议
- 请求被拒绝(403):检查API Key是否填写正确,以及是否在千聚后台的“IP白名单”中允许了小程序的服务器IP(如有配置)。
- 请求超时或失败:首先确认微信小程序合法域名是否已添加千聚的Base URL域名。其次,检查网络环境是否正常。
- 模型返回异常:确认使用的模型名称在千聚支持的列表中。可以访问 立即访问千聚 查看最新模型列表与文档。
- Token用量与计费:千聚采用按量计费,Token消耗可在后台实时查看,方便控制成本。
通过以上三步,你已经掌握了微信小程序接入模型中转站的核心方法:API Key和Base URL配置。千聚作为一款专注国内开发者的AI中转站,不仅提供稳定、易用的接口,还支持预充值购买Token,无需绑定国外信用卡,是微信小程序接入AI功能更优的选择。
下一步行动:
- 前往 千聚AI中转站官网 注册账号并获取API Key
- 在微信小程序后台配置合法域名
- 复制上面的示例代码,替换API Key和模型名,开始你的第一次AI调用
- 如果需要帮助,可以查看千聚官方的API接入教程和OpenAI兼容接口文档