AI插件修图怎么接入手机？小程序开发者的尝试日记

从挑SDK到真机跑通，我一共动了哪些地方

AI插件修图接入小程序，核心四步：开通插件使用权限、在app.json里声明、跳转插件修图页、回调里取回成图，正常一天能跑通。

我手里是给自家相册类小程序补一个AI修图入口，用户挑一张照片，点「一键修复」，出一张调过曝光、去过杂点的图。6月中旬开始选型，最后挑的这家插件商，看中两点：文档里贴了完整的小程序示例，以及官方提供14天不限次的试用期。说实话，选型阶段我花最多时间的不是比功能，是比文档里有没有把「回调参数」写清楚——很多插件demo一跑就通，一到异常分支全是空话。

动手环节没几下。先在小程序后台申请插件使用，填对方的AppID，等了大概两小时过审。然后改代码，app.json里加一段plugins声明，指定插件版本号，我当时锁的是2.3.0。真正业务侧就三行核心调用：构造参数、navigateTo跳到插件提供的修图页面、在回调里拿结果图。插件包本身320KB，挂在我的相册小程序上，首开耗时多了不到400毫秒，用户端几乎无感。

走这条路之前我也对比过另一条技术路线：不嵌插件，直接调云端的修图接口，自己画交互。区别在于插件方案把「选片、涂改、确认」那套界面整套外包了，你只管收图；接口方案自由度高，但上传、进度、失败重试全要自己写。我当时判断相册场景用户要的是「点了就出图」，就没自己造轮子。两条路写法上的差别，那篇讲AI开放修图接口的文章里拆得更细，好奇可以去翻。

有一点要先打预防针：体验损耗从第一天就在。插件默认上传前把图压到1280像素宽、JPEG质量80左右，云端处理完原样返回。2K图平均处理4到6秒。对聊天分享场景这够用，可相册用户里有不少是想修老照片的，他们会放大看细节。上线第一周就有用户留言「怎么修完反而糊了」，我把上传阈值手动放宽到1920像素，处理时长涨到8秒上下，投诉才停。

调用量和费用：8月账单一笔笔算给你看

这类插件按调用量阶梯计费，我8月修图调用4.2万次，扣掉每日免费额度实付612元，摊到每次约1分5厘。

计费结构不复杂。试用期14天不限次；转正式后，每天前1000次按0.02元一次，超出部分0.015元一次。听起来便宜，架不住量。我的小程序日活峰值那天有1.9万人用了修图，平均每人修2.3张。8月底拉账单，全月4.2万次调用，实付612元。这个数我原本预估在400元以内，多出来的部分全是周末贡献的——晚8点到10点两小时能吃掉全天四成的量。

钱是小事，排队才是大事。高峰期云端处理延迟从平时4秒一路涨到11秒，我盯着监控曲线，第一次见到9秒的时候还以为监控坏了。11秒意味着用户盯着转圈页面，跳出率肉眼可见地上来。后来我加了前端进度动画，把「正在修饰光影」这类步骤文案轮播出来，配合失败后自动重试一次，留存才稳住。这算是我花612元学费换来的认知：算成本不能只算单价，得把等待时间折进去。

要不要自建？我认真算过。按我的调用量租一台带GPU的云主机，最低配一个月也要一千六七，还得自己维护模型版本、扛并发。现阶段插件方案明显划算，等日调用破十万再重新算这笔账也不迟。

SDK一更新，接口全报错，那次怎么救回来的？

7月底插件升3.x大版本，旧接口直接失效，线上修图功能白屏。应急靠版本号锁死回滚，长期靠盯更新公告、灰度验证后再放全量。

翻车发生在7月31日晚上。插件商推了3.1.0大版本，我在测试环境看到提示顺手升了，没细看changelog就发版。结果当晚就炸了：真机上调用插件的editImage方法，控制台报「getExportedAPI: plugin editImage is not found」，修图入口整块白屏。原来3.x把editImage改名成了applyEdit，回调参数也从「code: 0表示成功」改成了「success: true」。用户消息群里已经有人问「怎么点不动了」，那滋味不好受。

应急动作其实就一个：把app.json里的插件版本从3.1.0锁回2.3.0，重新提审发版。微信小程序审核那次花了约两小时，凌晨一点线上恢复。用户骂声就压下去了。接着花了一个周末把新接口迁完，在测试环境把成功、失败、取消三个分支各跑了一遍，再走灰度发布，分两批放量，8月4日才全量切到3.x。

这事之后我改了三个习惯：订阅插件商的更新公告群；任何大版本先看接口变更日志再动手；升版永远走灰度，第一批只放10%流量。说白了，接插件就像租房子，房子不是你的，房东哪天换门锁你得第一时间知道钥匙在哪。这大概是我这轮折腾里最值钱的一条经验。

回头看，接入本身确实只花了一天，可后面每个周末都在跟账单、排队和版本更新打交道。AI修图功能给相册小程序带来了真金白银的留存，也让多了一摊需要长期伺候的依赖。要不要接，取决于你有没有耐心做这种「每月付点钱、隔三差五修一下」的维护者。我目前不后悔，但下一个小程序，我会更早把版本锁定和监控先搭好再上功能。