接入前需要准备什么
在动手写代码之前,先把三样东西准备好:一个可用的聚合平台账号、一组有效的API Key,以及该平台提供的Base URL地址。如果你还没有账号,可以先去注册一个AI中转站账号,通常注册后就能在控制台里创建API Key。
这里推荐使用千聚AI中转站官网完成注册和Key管理。千聚支持多模型聚合调用,覆盖OpenAI、GPT-5系列、Claude、Gemini、DeepSeek、Grok、Qwen、Kimi、豆包、GLM等主流模型方向,一套接口即可切换不同模型,适合减少多平台切换成本。
API Key和Base URL怎么获取
登录千聚后,进入控制台的“API Key管理”页面,点击创建新的Key,复制保存即可。Base URL通常在“接口文档”或“接入指南”页面可以找到,格式类似:
https://www.qianjuai.cc/v1
请务必确认你复制的是完整地址,不要漏掉末尾的/v1,很多接入失败都是因为Base URL少了一段路径。
| 配置项 | 示例值 | 注意事项 |
|---|---|---|
| API Key | sk-xxxxxxxxxxxx | 只显示一次,请立即保存 |
| Base URL | https://www.qianjuai.cc/v1 | 注意是否带/v1路径 |
| 模型名称 | gpt-4o / deepseek-chat | 以平台模型列表为准 |
微信小程序端接入步骤
在微信小程序里调用大模型接口,本质上就是发起一次HTTPS请求。以下是核心步骤:
- 在
app.js或独立配置文件中定义Base URL和API Key常量。 - 使用微信小程序的
wx.request发起POST请求,将模型名称和消息内容放入请求体。 - 在请求头中携带
Authorization: Bearer {API Key}。 - 处理返回结果,将模型回复渲染到页面。
一个最简的请求体结构如下:
{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "你好"}]
}
需要注意,微信小程序要求所有请求域名必须在小程序后台配置为合法域名,建议将Base URL对应的域名提前加入白名单,否则请求会被拦截。
常见配置错误排查
- 401错误:多为API Key错误或未在请求头中正确携带。
- 404错误:Base URL路径不正确,检查是否缺少
/v1。 - 模型不存在:模型名称拼写错误,建议去平台模型列表页复制完整模型ID。
如果以上排查后仍无法调用,可以前往立即访问千聚查看最新的接入文档,平台通常会在文档中标注当前支持的模型列表和调用示例。
下一步行动:登录千聚控制台,创建你的API Key,查看模型列表,购买Token后即可开始测试第一次模型调用。接口兼容OpenAI调用方式,如果你之前用过OpenAI的SDK,可以直接替换Base URL和Key完成切换。
- 微信小程序接入大模型聚合平台的完整API接入教程
- 千聚AI中转站Token购买与余额管理指南
- OpenAI兼容接口的Base URL配置方法详解
- 千聚官网最新模型列表与调用示例