准备工作:注册千聚AI中转站账号与购买Token
在进行微信小程序接入之前,首先需要完成账号注册并获取API调用凭证。具体步骤如下:
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,适合需要快速配置 Codex 令牌 API key 的用户。
- 访问 千聚AI中转站官网,完成账号注册。
- 登录后进入仪表盘,根据项目需求购买适量Token。千聚平台支持按量计费,适合从测试到正式上线的不同阶段,具体价格可前往官网实时查看。
- 在“API Key管理”页面创建新的API Key,并妥善保存。该Key将用于后续微信小程序端的所有请求鉴权。
完成以上步骤后,你就拥有了调用千聚平台上所有主流模型(如GPT-4、Claude、DeepSeek等)的基础条件。
微信小程序端配置Base URL与API Key
千聚AI中转站兼容OpenAI的接口格式,因此微信小程序中只需要配置三个核心参数即可发起调用:
- Base URL:统一设置为
https://api.token88.cc/v1 - API Key:使用上一步创建的密钥
- 模型名称:根据需求选择,如
gpt-4、claude-3-opus等
以下是一个示例配置(可在小程序app.js或请求工具中设置):
// 全局配置示例
const BASE_URL = 'https://api.token88.cc/v1';
const API_KEY = 'your-api-key-here';
将API Key替换为真实密钥后,即可在后续请求中复用此配置。这种统一接口设计大幅降低了微信小程序接入模型中转站的开发成本,无需为每个模型单独适配。
选择模型名称与发起调用
配置完成后,即可在小程序中使用wx.request发起一次模型调用。以下是一个简单的聊天补全请求示例:
wx.request({
url: BASE_URL + '/chat/completions',
method: 'POST',
header: {
'Authorization': 'Bearer ' + API_KEY,
'Content-Type': 'application/json'
},
data: {
model: 'gpt-4',
messages: [
{ role: 'user', content: '你好,请介绍一下自己。' }
]
},
success: function(res) {
console.log('AI回复:', res.data.choices[0].message.content);
},
fail: function(err) {
console.error('请求失败:', err);
}
});
注意:model字段可根据千聚平台支持的模型列表调整,例如claude-3-sonnet、deepseek-chat等。如果你需要查看更多可用的模型,建议直接访问千聚官网的模型列表页面进行查看。
常见问题与排查建议
在实际接入过程中,开发者可能会遇到以下情况:
- 401认证错误:请检查API Key是否正确复制,且未包含多余空格。
- 404模型不存在:确认模型名称是否在千聚平台支持范围内,不同模型有不同的标识符。
- 余额不足返回错误:可登录千聚后台查看当前Token余额,按需充值。
上述问题通常可以通过核对配置参数或补充Token解决。若遇到其他异常,建议优先查看千聚官网的文档说明或联系客服支持。
完成以上步骤后,你的微信小程序已经成功接入了模型中转站。接下来可以进一步探索多模型切换、流式输出等高级功能。千聚平台提供的统一接口,让后续扩展更加方便。
了解更多相关教程: