用AI开发微信小程序（三）：视频提取功能的云函数与API接口配置实战

1. 视频提取功能为什么卡在云函数这一层微信小程序做视频提取最容易踩的坑不是解析逻辑本身而是请求链路。你在本地用 Python 或 Node 跑一个解析服务浏览器里访问得好好的一放进小程序就报request:fail url not in domain list或者干脆提示域名必须 HTTPS。这不是代码写错了而是小程序的网络请求有硬性约束正式环境只允许请求已备案、已配置到后台白名单的 HTTPS 域名。视频提取功能的核心动作其实很清晰用户粘贴一条分享链接服务端解析出无水印视频地址小程序拿到地址后播放或下载。问题在于解析服务通常跑在自建服务器上而小程序不能直接调用它。这时候云函数就成了最省事的中转层——小程序调云函数云函数再去请求你的解析 API返回结果给前端。整条链路绕开了域名白名单和 HTTPS 证书的麻烦同时云函数天然支持 HTTPS 出站请求。这篇面向已经写过基础小程序的开发者重点讲三件事云函数的目录结构怎么组织、config.json和 API 调用骨架怎么写、以及一次完整的视频链接解析与提取验证流程怎么跑通。你跟着做完应该能拿到一个可用的视频提取链路而不是停留在“知道原理”的阶段。适合谁看手里已经有一个能跑的小程序项目想加视频提取功能但对云函数和接口配置不太熟的开发者。如果你还没建过小程序项目建议先把基础页面和云开发环境开起来再往下看。2. TaoToken 前置把模型调用和接口调试串起来视频提取功能本身不一定要用大模型但整个开发过程里有两处会用到 AI 能力一是让 AI 帮你生成云函数骨架和排错二是解析接口返回的字段结构不固定时用模型做一次结构化整理。我习惯把这类调用统一走 TaoToken省得每个服务单独配一套 Key。TaoToken 是一个模型调用与 API 管理的入口官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的作用是让你用一个 Key 就能调用多种模型同时在控制台里看到每次请求的消耗和返回调试接口时比较直观。你需要提前准备的东西一个 TaoToken 账号进入控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite如果只是调试模型返回用模型对话页面就够了https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite如果你打算长期用 AI 辅助写小程序代码可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteKey 管理页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite拿到 Key 之后先别急着写云函数。建议在模型对话页面里发一条测试请求确认 Key 能用、返回正常。这一步花两分钟能避免后面云函数报 401 时你分不清是 Key 问题还是代码问题。注意API Key 只放在云函数的环境变量或服务端配置里不要写进小程序前端代码。小程序包是可以被反编译的前端出现 Key 等于公开。3. 云函数目录结构与 config.json 配置云函数的目录结构决定了它能不能被正确部署和调用。微信云开发的云函数标准结构是这样的cloudfunctions/ └── videoExtract/ ├── index.js ├── package.json └── config.jsonindex.js是入口文件package.json声明依赖config.json用来配置云函数的权限和超时等参数。很多人忽略config.json结果云函数请求外部接口时被拦或者超时时间不够导致解析失败。先看config.json的写法{ permissions: { openapi: [] }, timeout: 20, envVariables: { TAOTOKEN_API_KEY: 你的Key, EXTRACT_API_BASE: https://your-domain.com } }这里有几个关键点。timeout设成 20 秒是因为视频解析接口有时候响应慢默认 3 秒很容易超时。envVariables里放的是环境变量云函数运行时可以通过process.env读取这样 Key 不会硬编码在代码里。permissions.openapi留空是因为我们不需要调用微信开放接口只做外部 HTTP 请求。package.json里需要声明 HTTP 请求库。云函数环境自带axios的情况不统一稳妥做法是显式声明{ name: videoExtract, version: 1.0.0, dependencies: { axios: ^1.6.0 } }写完这两个文件后在微信开发者工具里右键videoExtract目录选择“上传并部署云端安装依赖”。部署完成后云函数列表里能看到它状态是正常的。这里有个容易踩的坑config.json修改后必须重新部署才生效。我试过改完超时时间直接测试结果还是按旧配置跑排查了半天才发现是没重新上传。4. 云函数 API 调用骨架与解析逻辑云函数的核心逻辑分三步接收小程序传来的分享链接、请求解析 API、把结果整理后返回。下面是一个可运行的骨架你可以直接替换EXTRACT_API_BASE和字段名。const cloud require(wx-server-sdk); const axios require(axios); cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV }); exports.main async (event, context) { const { shareLink } event; if (!shareLink || typeof shareLink ! string) { return { code: 400, msg: 缺少分享链接 }; } const apiBase process.env.EXTRACT_API_BASE; const apiKey process.env.TAOTOKEN_API_KEY; try { const resp await axios.post( ${apiBase}/api/video/download, { url: shareLink }, { timeout: 15000, headers: { Content-Type: application/json, Authorization: Bearer ${apiKey} } } ); const data resp.data; if (!data || data.code ! 0) { return { code: 500, msg: 解析失败, detail: data }; } const videoInfo data.data || {}; const playUrl videoInfo.play_url || videoInfo.url || ; const title videoInfo.title || 未命名视频; if (!playUrl) { return { code: 500, msg: 未获取到视频地址, detail: videoInfo }; } return { code: 0, msg: ok, data: { title, playUrl, cover: videoInfo.cover || , duration: videoInfo.duration || 0 } }; } catch (err) { console.error(videoExtract error:, err.message); return { code: 500, msg: 请求解析服务失败, detail: err.message }; } };这段代码里event是小程序调用时传进来的参数shareLink就是用户粘贴的分享链接。请求解析服务时带了Authorization头如果你的解析服务不需要鉴权可以去掉。返回结构统一成{ code, msg, data }前端处理起来简单。小程序端调用云函数的写法wx.cloud.callFunction({ name: videoExtract, data: { shareLink: 用户粘贴的分享链接 }, success: res { const result res.result; if (result.code 0) { this.setData({ playUrl: result.data.playUrl, videoTitle: result.data.title }); } else { wx.showToast({ title: result.msg, icon: none }); } }, fail: err { console.error(云函数调用失败, err); wx.showToast({ title: 调用失败, icon: none }); } });前端拿到playUrl后直接绑定到video组件的src属性就能播放。如果要下载到本地需要用wx.downloadFile配合wx.saveVideoToPhotosAlbum但下载的域名同样要在小程序后台配置合法域名或者也走云函数中转。5. 完整验证流程从请求到结果返回配置写完后跑一次完整验证。步骤如下第一步在微信开发者工具的云函数目录里右键videoExtract选择“本地调试”。本地调试可以让你在不上传的情况下测试逻辑但环境变量需要在调试面板里手动填。第二步在调试面板的“测试参数”里填入{ shareLink: https://v.douyin.com/xxxxx/ }第三步点击“调用”观察返回结果。如果返回code: 0并且data.playUrl是一个可访问的地址说明链路通了。如果返回code: 500看detail字段里的错误信息。第四步把云函数部署到云端在小程序页面里真实操作一次粘贴链接、点击解析、等待结果、点击播放。这一步能暴露本地调试发现不了的问题比如环境变量没生效、超时时间不够、域名白名单没配。实测下来最常见的失败原因是解析服务返回的字段名和代码里写的不一致。比如有的服务返回video_url有的返回play_url代码里只取了一个就会拿到空值。解决办法是在云函数里做兼容const playUrl videoInfo.play_url || videoInfo.video_url || videoInfo.url || ;另外如果解析服务本身需要先获取一个 token 再请求那云函数里要加一步 token 获取逻辑不能直接发解析请求。这个要看你的解析服务文档。验证通过后建议在云函数里加一行日志记录每次解析的链接和结果状态方便后面排查问题console.log(extract result:, { shareLink, code: data.code, hasUrl: !!playUrl });6. 本篇常见错误排查报错一request:fail url not in domain list这个错误通常出现在小程序前端直接请求解析 API 的时候。原因是解析 API 的域名没有配置到小程序后台的“request 合法域名”里。解决办法有两个一是把域名配到后台白名单但要求域名已备案且支持 HTTPS二是走云函数中转前端只调云函数不直接请求外部 API。推荐第二种省去备案和证书的麻烦。报错二云函数返回code: 500detail显示timeout of 15000ms exceeded解析服务响应太慢超过了云函数里设置的timeout。先确认config.json里的timeout是否大于 axios 的timeout两者要匹配。如果解析服务本身就需要 20 秒以上那要考虑换服务或者做异步处理。另外云函数的超时上限和套餐有关免费版通常最多 20 秒超出要升级。报错三Cannot find module axios云函数部署时没有安装依赖。检查package.json里是否声明了axios然后重新上传并选择“云端安装依赖”。如果本地node_modules里有但云端没有说明上传时没勾选安装依赖选项。报错四返回code: 0但playUrl为空解析服务返回了结果但字段名和代码里取的不一致。把detail里的原始返回打印出来对照字段名修改取值逻辑。常见字段有play_url、video_url、url、download_url做一层兼容取值。报错五小程序端调用云函数报cloud function execution error云函数内部抛了未捕获的异常。检查index.js里是否有try/catch包住主逻辑以及cloud.init是否在入口处调用。另外云函数名称要和wx.cloud.callFunction里的name完全一致大小写敏感。如果排查过程中需要确认模型返回或接口调试可以到模型对话页面发一条测试请求https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果是要长期做小程序开发、频繁让 AI 生成代码和排错Coding Plan 会更顺手https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Key 的管理和新建在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。接入文档里有完整的请求示例和参数说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后补一个实用技巧云函数的环境变量在本地调试时不会自动读取config.json里的配置需要在调试面板手动填。部署到云端后才会按config.json生效。这个差异导致很多人本地测试通过、线上失败排查时先确认环境变量是否在两边都正确设置。