第一步:注册千聚并获取API Key
在开始公众号接入之前,你需要先拥有一个千聚账号。整个流程非常简单,几分钟即可完成。
- 访问 千聚AI中转站官网,点击注册按钮,填写基本信息完成账号创建。
- 登录后,进入“API Key管理”页面,点击“创建新Key”。
- 系统会生成一串密钥,复制并妥善保存。注意,这个Key相当于你调用所有模型的通行证,不要泄露给无关人员。
千聚支持多种主流模型,包括GPT-5系列、Claude、Gemini、DeepSeek、Qwen、Kimi、豆包、GLM等,一份API Key即可调用全部,无需为每个平台单独注册。
第二步:配置Base URL和模型名称
千聚提供完全兼容OpenAI接口的Base URL,这意味着你现有的OpenAI SDK代码几乎无需修改,只需替换两个参数即可。
在Python中,配置方式如下:
import openai
openai.api_key = "你的千聚API Key"
openai.base_url = "https://www.qianjuai.cc/v1"
在Node.js中,配置方式类似:
const { Configuration } = require("openai");
const config = new Configuration({
apiKey: "你的千聚API Key",
basePath: "https://www.qianjuai.cc/v1"
});
模型名称根据实际需求选择,例如“gpt-4”、“claude-3-opus”、“deepseek-chat”、“glm-4”等。千聚支持实时切换模型,你可以在代码中动态指定,适合公众号根据不同场景调用不同AI能力。
第三步:编写调用代码并测试
假设你的公众号后端使用Python Flask框架,在路由处理函数中调用模型接口的示例代码如下:
response = openai.ChatCompletion.create(
model="gpt-4",
messages=[{"role": "user", "content": "你好,请介绍一下你的功能"}],
)
reply = response.choices[0].message.content
Node.js版本的调用示例:
const openai = new OpenAIApi(config);
const response = await openai.createChatCompletion({
model: "gpt-4",
messages: [{role: "user", content: "你好"}]
});
const reply = response.data.choices[0].message.content;
将返回的回复内容直接返回给公众号用户即可。整个过程与调用OpenAI官方接口完全一致,学习成本极低。
常见配置问题排查
| 问题现象 | 可能原因 | 建议操作 |
|---|---|---|
| 401鉴权失败 | API Key错误或已过期 | 重新生成Key并检查代码中的配置 |
| 404模型不存在 | 模型名称拼写错误或未开通 | 前往官网查看支持的模型列表 |
| 429请求过多 | 账户余额不足或并发限制 | 购买Token或调整调用频率 |
| 连接超时 | 网络环境或Base URL错误 | 确认Base URL为https://www.qianjuai.cc/v1 |
如果遇到其他问题,建议先检查API Key和Base URL是否正确,再确认模型名称是否在千聚支持的范围内。余额不足时,可随时在官网充值。
相关资源:
Codex 一键安装包: https://token88.cc/codex-qianju
特别推荐:支持 Windows 和 MacOS一键安装,里面还有一键配置 Codex 令牌 API key 的工具,安装codex之后,用一键配置API key 的工具马上就能用,哪怕你没有海外手机也能正常使用,同时token费用比官网还便宜90%多~