DeepSeek API 接入微信公众号与小程序实操,零基础怎么用?3分钟极速上手

兄弟们,站长今天直接给你上干货。网上那些教程绕来绕去,要么让你看文档,要么让你配服务器,看完还是懵。站长今天这篇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 步操作:从零到能聊天

🔥 【开发者算力福利】高并发 AI 部署 GPU / 独享云服务器限时特惠

本地算力不足或遇到 CUDA OOM 显存溢出?推荐搭配高性价比独享 GPU 云服务器:

👉 点击前往领取开发者限时优惠券

第一步:写一个“中转函数”

微信服务器不会直接调 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 时,先填一个固定的验证码,代码里直接返回这个验证码,等验证通过了再改成真实逻辑。具体看第三步。

第二步:部署到云函数并绑定域名

以腾讯云为例(阿里云类似):

  1. 打开云函数控制台,新建函数,选“从头开始”,运行环境 Python 3.9。
  2. 把上面的代码粘贴进去,记得把 api_key 换成你自己的
  3. 部署完成后,点“触发管理”,创建一个 API 网关触发器,路径填 /wechat,请求方法选 POST(微信回调用),然后启用“集成响应”(不然返回格式会乱)。
  4. 拿到 API 网关给你的默认域名(形如 xxx.service.tce.fsphere.cn),然后去你的域名服务商加一条 CNAME 记录,指向这个域名,或者直接在 API 网关里绑定你的自定义域名(需要已备案)。站长建议直接绑定自定义域名,因为微信不认默认域名。
  5. 给你的域名申请 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 部署排错手册、提示词全集与服务器限时优惠整理如下,即拿即用:

滚动至顶部