
微信小程序接入模型中转站的前提条件
在动手写代码之前,需要准备好以下基础条件:
- 一个已注册并完成认证的微信小程序账号(用于获取AppID等基础信息)。
- 一个千聚AI中转站官网账号,用于管理API Key和Token余额。
- 熟悉微信小程序云开发或自建后端服务器的基本流程。
微信小程序本身不支持直接调用外部HTTP接口(需配置合法域名),因此你需要将模型中转站的请求通过后端转发,或使用云函数进行代理。这一步骤虽然看似繁琐,但通过合理的API Key和Base URL配置,可以大幅降低接入复杂度。
核心配置:API Key、Base URL与模型名称
无论你选择哪个模型中转站,微信小程序接入时都需要明确以下三个参数:
| 参数 | 说明 | 示例值(千聚为例) |
|---|---|---|
| API Key | 用于身份验证的密钥,需从平台后台获取 | sk-xxxxxxxxxxxxxxxx |
| Base URL | API接口的基础地址,决定请求发送到哪里 | https://api.token88.cc/v1 |
| 模型名称 | 指定调用的具体模型,如gpt-4o、claude-3等 | gpt-4o |
在微信小程序的后端代码中,配置方式大致如下(以Node.js为例):
const apiKey = 'sk-你的API Key';
const baseURL = 'https://api.token88.cc/v1';
const model = 'gpt-4o';
注意:API Key务必保存在服务端,不要直接暴露在小程序前端代码中,否则存在泄露风险。千聚AI中转站的Base URL兼容OpenAI接口格式,因此你现有的OpenAI SDK或HTTP请求代码只需修改Base URL和API Key即可复用。
微信小程序接入流程步骤
- 注册并获取API Key:登录立即访问千聚,在控制台创建API Key,并记录Base URL。
- 配置后端代理:在小程序云函数或自建服务器中,将请求转发至千聚的Base URL,并携带API Key进行鉴权。
- 设置合法域名:在小程序后台的“开发设置”中,将千聚的Base URL域名(如api.token88.cc)添加到request合法域名列表。
- 编写调用代码:使用wx.request或云函数调用,传递模型名称和消息内容,接收返回结果。
- 测试与调试:先用简单的对话请求测试,确认返回正常后再集成到正式功能中。
整个过程如果配置正确,从获取API Key到第一次成功调用,通常只需十几分钟。如果你对Base URL或模型名称有疑问,可以查看千聚官网的文档,里面提供了详细的参数说明和代码示例。
常见问题与排查
- 返回401错误:检查API Key是否正确,是否在有效期内。
- 返回404错误:确认Base URL是否完整(是否包含/v1路径),以及模型名称是否支持。
- 请求超时:检查小程序合法域名是否已添加,以及网络环境是否稳定。
微信小程序接入模型中转站,本质上就是一次标准的HTTP请求配置。只要抓住API Key、Base URL和模型名称这三个关键点,大部分问题都能快速定位和解决。
下一步行动
现在你已经掌握了微信小程序接入模型中转站的核心配置方法。接下来,建议你直接访问千聚AI中转站官网,注册账号并获取API Key,然后按照上述步骤开始第一次调用测试。记得先去控制台查看可用的模型列表和Token购买方案,选择最适合你项目的模型进行集成。