兄弟们,站长今天直接给你上干货。网上那些教程绕来绕去,要么让你看文档,要么让你配服务器,看完还是懵。站长今天这篇DeepSeek API 接入微信公众号与小程序实操,你就跟着点,3分钟跑通,不扯别的。
一、前置准备:你只需要这三样东西
⚡ 【免费资源】DeepSeek/Ollama 部署排错手册 + 全套 AI 提示词资料包
站长已将大模型部署排错指南、常用环境配置文件及 AI 提效指令库整合分享至夸克网盘,可极速免费转存:
别慌,站长给你列个清单,缺一样都玩不转:
- 一个 DeepSeek 开放平台账号(去 platform.deepseek.com 注册,手机号就能搞定,别怕)。注册完进控制台,左侧菜单找到“API Keys”,点创建,复制那串 sk- 开头的密钥。这玩意儿就是你的钥匙,丢了就重新生成,别泄露。
- 一个微信公众号(服务号或订阅号都行),或者一个小程序账号。没有就去 mp.weixin.qq.com 注册,个人主体也能注册订阅号,免费。注意:个人主体的小程序很多接口受限,但基础的消息回复没问题。
- 一个能跑代码的环境。站长知道你零基础,所以不用买服务器,直接用腾讯云函数(SCF)或者阿里云函数计算,都有免费额度。或者你本地装个 Python 也行,但微信服务器要回调你的公网地址,所以本地跑还得用内网穿透(ngrok),麻烦。站长推荐直接用云函数,省事。
另外,你需要一个 HTTPS 域名,微信要求回调地址必须是 HTTPS。没有?去腾讯云或阿里云买个域名,一年几十块,再申请个免费 SSL 证书,云函数自带域名绑定功能,跟着控制台点就行。
二、极速 3 步操作:从零到能聊天
第一步:写一个“中转函数”
微信服务器不会直接调 DeepSeek 的 API,你得写个中间层。站长给你一段最简 Python 代码,你复制到云函数里,运行时选 Python 3.9 以上。
import json
import requests
def main_handler(event, context):
# 微信发来的 POST 请求体是 XML,但云函数已经帮你解析成 JSON 了
# 实际部署时,你需要解析 event 里的 body 字段,这里简化为直接取消息
body = json.loads(event.get('body', '{}'))
# 公众号/小程序发来的用户消息
user_msg = body.get('Content', '') # 公众号用这个字段
# 调用 DeepSeek API
api_key = "你的DeepSeek密钥"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
payload = {
"model": "deepseek-chat",
"messages": [{"role": "user", "content": user_msg}]
}
resp = requests.post("https://api.deepseek.com/chat/completions",
headers=headers, json=payload, timeout=10)
reply = resp.json()["choices"][0]["message"]["content"]
# 返回微信需要的 XML 格式(公众号)或 JSON(小程序)
# 站长这里给你公众号的 XML 格式
return {
"statusCode": 200,
"headers": {"Content-Type": "application/xml"},
"body": f"{int(time.time())} "
}
注意:上面代码是示意,实际部署你必须处理微信的签名验证(echostr)。站长教你个懒办法:云函数触发器配置成“API 网关触发”,然后在微信后台填 URL 时,先填一个固定的验证码,代码里直接返回这个验证码,等验证通过了再改成真实逻辑。具体看第三步。
第二步:部署到云函数并绑定域名
以腾讯云为例(阿里云类似):
- 打开云函数控制台,新建函数,选“从头开始”,运行环境 Python 3.9。
- 把上面的代码粘贴进去,记得把 api_key 换成你自己的。
- 部署完成后,点“触发管理”,创建一个 API 网关触发器,路径填 /wechat,请求方法选 POST(微信回调用),然后启用“集成响应”(不然返回格式会乱)。
- 拿到 API 网关给你的默认域名(形如 xxx.service.tce.fsphere.cn),然后去你的域名服务商加一条 CNAME 记录,指向这个域名,或者直接在 API 网关里绑定你的自定义域名(需要已备案)。站长建议直接绑定自定义域名,因为微信不认默认域名。
- 给你的域名申请 SSL 证书(腾讯云有免费版),在 API 网关里配置好 HTTPS。
第三步:微信后台配置回调地址
公众号:登录微信公众平台,左侧“设置与开发” → “基本配置” → “服务器配置”。URL 填你的 https://你的域名/wechat,Token 随便填一个字符串(比如 mystation),EncodingAESKey 点随机生成。提交后微信会发一个 GET 请求带 echostr 参数,你的代码需要返回这个参数才能通过验证。站长建议你先在代码里写死返回 echostr,通过后再改回正常逻辑。
小程序:小程序后台 → “开发管理” → “开发设置” → “服务器域名”。把 https://你的域名 加到 request 合法域名里。然后在小程序前端用 wx.request 请求你的云函数 URL,把用户输入发过去,再把返回的回复显示出来。前端代码站长不贴了,就是普通 POST 请求。
避坑提示卡片
💡 关联延伸阅读:如果你在配置过程中遇到相关报错,请参阅站长之前的解决教程:DeepSeek API 调用返回 429 Rate Limit 频率限制解决方案:从业务架构到代码级高并发实战
坑1:微信要求 URL 必须 80 或 443 端口,且必须 HTTPS。 别用 IP 地址,别用 HTTP,否则验证永远失败。站长见过太多人卡在这。
坑2:云函数默认超时 3 秒,DeepSeek 响应可能慢。 去云函数配置里把超时时间改成 30 秒,不然用户问个长问题,微信直接报“服务异常”。
坑3:公众号被动回复有 5 秒超时限制。 DeepSeek 有时候要算好几秒,所以站长建议你:先立即返回“收到,思考中…”,然后用客服消息接口异步推送结果。但零基础的话,先直接同步返回,超过 5 秒就重试一次,或者让用户多问几遍。进阶玩法以后再讲。
坑4:DeepSeek API 有并发限制和速率限制。 免费额度下,QPS 不高。如果多人同时用,会报 429。站长建议你在代码里加个简单队列,或者限制每个用户 5 秒内只能发一条消息。
坑5:小程序里不能直接调用 DeepSeek API。 会跨域,而且密钥会暴露。必须走你的云函数中转,这是安全底线。
最后站长说两句
这套流程,站长自己跑通了,前后不到 10 分钟。你跟着做,遇到任何一步报错,先看日志(云函数控制台有日志查询),99% 是 JSON 格式问题或者 URL 没配对。记住,DeepSeek API 接入微信公众号与小程序实操的核心就是“中转”二字,微信不能直连外部 API,你必须有个中间层。
跑通之后,你可以给公众号加个菜单,或者在小程序里搞个聊天界面,再进阶可以做多轮对话(需要维护 session),或者接入知识库。站长后续会出进阶教程,但今天这篇,你先把基础通了再说。
有问题评论区留言,站长看到就回。别问“在吗”,直接贴报错日志。
相关 AI 排错与深度技术延伸
⚡ 开发者实操必备资源与算力限时特惠通道
阅读完本教程准备实操?站长已将 AI 部署排错手册、提示词全集与服务器限时优惠整理如下,即拿即用: