微信小程序接入千聚:三个核心配置详解
在开始代码开发前,需要先理解千聚平台对这三个参数的映射方式:
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
- API Key:登录千聚后台后,可在“API Key管理”页面生成专属密钥。每个Key可以绑定额度、限制权限,方便团队管理。
- Base URL:千聚提供统一的OpenAI兼容接口地址。配置时将此地址填入小程序的请求域名列表,即可完成网络连通。
- 模型名称(Model):千聚聚合了GPT、Claude、Gemini、DeepSeek等系列模型,每个模型都有固定的字符串名称。调用时只需修改model字段,无需更换接口地址。
| 模型类别 | 示例模型名 | 适用场景 |
|---|---|---|
| GPT系列 | gpt-4o / gpt-4 | 复杂对话、代码生成 |
| Claude系列 | claude-3-opus | 长文本分析、合规审查 |
| 国产模型 | deepseek-chat / qwen-max | 成本敏感、中文场景 |
实际可用模型及最新价格,建议直接查看千聚AI中转站官网获取实时信息。
微信小程序调用千聚中转站的完整步骤
以下步骤从零开始,帮助你快速接入一个小型对话功能。
- 注册千聚账号并获取API Key
访问千聚官网完成注册,在控制台创建API Key并保存。建议先购买适量Token用于测试。 - 添加小程序合法域名
在微信公众平台“开发设置”中,将千聚的Base URL域名加入request白名单。 - 编写小程序代码
下面是一个基于wx.request的示例,涵盖了三个核心配置:
const baseURL = 'https://api.token88.cc/v1'; // Base URL
const apiKey = 'sk-你的密钥'; // API Key
wx.request({
url: baseURL + '/chat/completions',
method: 'POST',
header: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ' + apiKey
},
data: {
model: 'gpt-4o',// 模型名称
messages: [{ role: 'user', content: '你好' }]
},
success(res) { console.log(res.data); }
});
将上述代码中的API Key和模型名替换为千聚后台实际的值,即可发起第一次调用。记得在回调中处理返回的token消耗数据。
千聚方案如何保障微信小程序的接入稳定性
很多开发者担心中转站会带来额外延迟或不可用风险。千聚通过以下几点让接入更可靠:
- 统一兼容接口:所有模型均使用OpenAI格式,代码迁移成本低,换模型只需改model字段。
- 国内优化网络:提供适合国内环境的Base URL,相比直接请求海外接口更有利于小程序的响应速度。
- Token灵活管理:支持按量购买和余额查询,方便控制成本;同时可以在线切换模型,便于测试稳定性。
- 多模型备用:如果一个模型出现波动,可以快速切换到其他模型(如从GPT切换到Claude),中断时间极短。
这种设计尤其适合对稳定性要求较高的微信小程序商业场景,避免因单一接口故障导致服务不可用。
接入时的常见问题与自查建议
如果第一次调用返回错误,可以从以下几点排查:
- Base URL末尾没有加版本路径?千聚的标准地址为
https://api.token88.cc/v1,不要忽略/v1。 - 模型名称拼写是否正确?建议从千聚后台“模型列表”直接复制。
- API Key是否过期或余额不足?登录后检查Key状态和Token余额。
- 域名是否已加入白名单?确认
api.token88.cc已添加。
如仍无法解决,可参考千聚官网的API文档进一步调试。
现在开始你的微信小程序模型接入
从获取API Key到第一次调通,通常只需十分钟。访问立即访问千聚注册账号、查看完整模型列表并购买Token,根据本文的配置思路即可快速上线。一套API Key管多个模型,千聚让微信小程序的AI能力搭建更省心。