为什么微信小程序需要独立配置Base URL
微信小程序的网络请求有严格的域名白名单机制,所有请求域名都需要提前在后台配置。这意味着你无法像在PC端一样直接调用OpenAI或其他海外模型的官方接口。一个更便捷的方案是通过AI中转站——它提供统一的Base URL,你只需要把这个中转站的域名加到小程序的合法域名列表中,后续的模型切换都不需要再修改小程序配置。
第一步:注册并获取API Key
在开始配置代码之前,先准备好访问凭证。你需要做三件事:注册一个AI中转站账号、购买Token用于后续调用、生成自己的API Key。整个过程可以在 千聚AI中转站官网 上完成,注册后Dashboard里就有创建API Key的入口。每个开发者可以创建多个Key,方便按项目或环境做隔离管理。
第二步:配置微信小程序的合法域名
进入微信小程序管理后台,找到“开发”下的“服务器域名”设置。在“request合法域名”中,填入你从千聚AI中转站获取的Base URL里的域名部分。以千聚为例,Base URL一般为 https://api.token88.cc/v1,那么你需要在域名列表中添加 https://api.token88.cc。保存后,小程序内部的网络请求才能正常访问中转站。
第三步:编写小程序端调用代码
微信小程序不支持直接使用Node.js的官方SDK,因此需要自己封装一个简单的请求函数。核心配置只有三个参数:API Key、Base URL 和 模型名称。以下是基于千聚中转站配置的示例代码片段:
const API_KEY = '你的API Key';
const BASE_URL = 'https://api.token88.cc/v1';
const MODEL = 'gpt-4o';
实际调用时,使用小程序的 wx.request 向 BASE_URL/chat/completions 发送POST请求,头部携带Authorization: Bearer API_KEY,body中传入包含模型名、消息数组等参数。这种调用方式与OpenAI官方接口完全兼容,因此熟悉OpenAI接口的开发者几乎不需要额外学习成本。
第四步:处理响应数据
请求成功后,小程序的success回调里会收到与OpenAI结构一致的返回内容,包括choices数组、content文本等。你只需要从中提取出content字段,即可渲染到小程序的页面上。需要注意的是,为了提升用户体验,建议在加载时显示一个简单的loading状态,并在接口超时或出错时给出友好的提示。
如果测试中出现“域名不在合法列表中”或“request:fail”的错误,优先检查小程序管理后台的域名白名单是否填写正确。另外,在开发工具中需要勾选“不校验合法域名”选项,方便本地调试。生产环境则必须完整配置域名。
集成多模型:同一套代码切换不同AI
通过中转站,你只需要在小程序中预设几个模型名称,例如gpt-4o、claude-3-opus、deepseek-chat,然后在UI上增加一个模型选择器。用户选择不同模型时,代码中只改变MODEL这个变量的值,其余请求逻辑完全不变。这种设计大幅减少了多模型接入时的维护成本,让微信小程序的AI功能更灵活。
想要查看当前支持的所有模型并购买Token,可以直接访问 立即访问千聚,在模型列表页面选择适合你业务的方案。千聚AI中转站提供了一个更便于统一管理的调用入口,适合希望降低接入复杂度的微信小程序开发者。
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~