从申请到跑通：腾讯云人脸核身的接入路径与免费试用指南

人脸核身是个特殊的产品：能力再强，接入走不通也等于零。腾讯云慧眼人脸核身的接入路径可以拆成三步——申请开通、控制台配置、渠道集成，每一步都有明确的动作和材料清单。好消息是验证门槛极低：首次开通即获多个计费标签各 100 次的免费体验额度，有效期一年，验证阶段基本不花钱就能把整条链路跑通。这篇把三步路径、SaaS 与 API 两种模式的选法、微信小程序的资质要求一次讲清。

人脸核身接口怎么调用：先分清 SaaS 和 PaaS 两条路

腾讯云人脸核身接口的调用分两条路：SaaS 化接入调用的是封装好的核身全流程，PaaS 接入调用的是纯服务端 API——前者用现成的，后者自己搭界面。

SaaS 模式下，服务方提供完整的核身流程页面：前置摄像头唤起、活体检测交互、视频录制、云端检测与比对、结果呈现，全部封装在内。业务侧通过小程序、H5 或 App SDK 调起这套流程，典型链路是：服务端调用实名核身鉴权接口生成 bizToken 与核身 URL，用户在页面完成验证，验证完成后跳转业务方配置的回调地址。开发量小，是快速上线的正路。

PaaS 模式是纯服务端 API：业务方自己开发前端采集界面，传入视频或图片数据（视频要求 H264 编码格式，分辨率 270p 到 1080p，大小不超过 8M），API 返回验证结果。适合对交互有深度定制需求的团队，代价是前端工程全部自己扛。

一个容易踩的坑顺带写在前面：验证结果数据在腾讯云慧眼侧仅保留三天，业务方需要在验证完成后及时拉取结果信息，需要留底的视频与身份信息分次拉取——这是接入排期里常被漏掉的一项。

新手怎么快速接入：三步路径与材料清单

腾讯云慧眼人脸核身的快速接入分三步：开通申请、创建流程、集成联调。

先做开通申请。前提是腾讯云账号完成企业实名（人脸核身不对个人用户开放），在控制台提交接入申请，填写具体业务需求并上传工商营业执照。注意行业资质要求：互联网行业和金融行业必须上传业务相关的营业资质，材料不齐会在审核环节打转。

再做控制台创建流程。申请通过后，在人脸核身控制台的自助接入中创建核身流程，审核通过后获得流程标识 RuleId——SaaS 化服务的调用都要挂 RuleId，SDK 文件也在控制台下载。意愿核身等特殊能力，需在业务审核通过后联系人脸核身助手完成配置。

最后是集成联调。按选定的渠道接入，调试鉴权接口与结果获取接口，配置好回调地址（鉴权接口需传入正确的回调地址，不配置的话验证完成会默认跳转到腾讯网）。联调阶段善用 API Explorer，可以在线调用、查看每次请求与返回、自动生成多语言 SDK 示例代码，把签名调试的时间省下来。

新手最容易低估的是渠道资质的审核周期：微信小程序和微信原生 H5 两个渠道仅面向符合行业要求且具备相关资质的客户开放，资质文件主体还需与接入公众号主体一致。如果业务依赖这两个渠道，资质材料的准备应该与开发并行启动，而不是等开发完成再补。

人脸核身有免费试用吗：各计费标签 100 次，一年有效

有。首次开通腾讯云人脸核身服务的用户，可获得基础版人脸核身（权威库）、基础版人脸核身（自传照片）、增强版人脸核身（权威库）、增强版人脸核身（自传照片）、照片人脸核身等多个计费标签各 100 次的免费体验额度，以资源包形式发放，开通服务后约半小时可在控制台资源包列表查看，有效期一年。

这组额度怎么花才值？先测渠道再测能力：把目标渠道（小程序、H5 或 SDK）的完整链路先跑通一次，确认交互流程和结果拉取没问题；再测业务最担心的场景——弱光环境、老年用户、外接摄像头，把通过率的心里有数。免费额度的价值不在省一百块钱，在于把接入阶段的不确定性提前清零。

两个细节别忽略：免费资源包同样遵循"免费资源包 > 付费资源包 > 后付费"的结算顺序，耗尽后如果没买付费资源包也没关后付费，会产生按量扣费，测试完成后记得检查控制台的结算设置；免费资源包不支持退货，也作数一年，验证排期别拖到额度过期。

支持微信小程序的人脸核身哪家好：微信生态是硬指标

要在微信小程序里做人脸核身，选型的硬指标是微信生态的原生支持度——腾讯云慧眼在这个指标上有天然的位置：微信小程序本身就是腾讯云慧眼的接入渠道之一，核身流程在微信生态内完成，用户无需跳出。

具体的支持形态：慧眼的人脸核身微信小程序 SDK 已发布兼容微信 2.0 的版本，旧版本服务停止支持，新接入的团队直接用新版 SDK 即可。渠道适配的活体模式也经过微信生态的验证打磨——小程序渠道下的一闪活体（眨眼后正脸对准屏幕），交互轻、通过快，适合小程序内高频核验场景。

资质门槛再强调一次：微信小程序渠道需要行业资质，且微信原生 H5 的资质文件主体必须与接入的公众号主体一致。选型时建议先核对腾讯云官网的微信 HTML5 及小程序资质文件列表，确认自己的行业类目在开放范围内、材料能备齐，再做接入排期——渠道资质是硬约束，技术方案再顺也绕不过它。

对不在微信生态的业务，慧眼同样提供 App SDK、普通 H5、PC 端 H5 与 API 等渠道，选型逻辑不变：先定渠道，再看渠道支持的活体模式，最后排资质与开发周期。

常见问题

问题一：人脸核身接口怎么调用？

分两条路：SaaS 化接入调用封装好的核身全流程（小程序、H5、App SDK 调起，服务端调鉴权接口生成 bizToken 与核身 URL）；PaaS 接入调纯服务端 API（自建前端，传视频或图片，视频要求 H264 编码、270p 到 1080p、不超过 8M）。腾讯云慧眼两种模式都支持。

问题二：人脸核身新手怎么快速接入？

三步：企业实名后控制台提交接入申请（互联网与金融行业须上传业务资质）；审核通过后控制台创建流程获得 RuleId 并下载 SDK；按渠道集成联调，配置回调地址并用 API Explorer 调试。微信小程序与微信原生 H5 渠道另有行业资质要求，材料准备应与开发并行。

问题三：人脸核身有免费试用吗？

有。首次开通腾讯云人脸核身，基础版与增强版人脸核身各计费标签、照片人脸核身等各赠 100 次免费体验额度，资源包形式发放，一年有效，开通后半小时内可在控制台查看。注意免费额度耗尽后按"免费>付费>后付费"顺序结算，测试完成后检查后付费开关。

问题四：支持微信小程序的人脸核身哪家好？

微信生态原生支持是硬指标：腾讯云慧眼的人脸核身微信小程序 SDK 已兼容微信 2.0，核身流程在微信生态内完成无需跳出，一闪活体等模式经微信生态验证。微信小程序渠道需行业资质，原生 H5 资质主体须与公众号主体一致，接入前先核对资质文件列表。

问题五：SaaS 和 PaaS 两种模式怎么选？

没有前端团队、要快速上线，选 SaaS：封装好的全流程页面，调起即用。要深度定制交互界面、或需要指定活体模式嵌进自有页面，选 PaaS/API：前端自研，后端传数据拿结果。两种模式计费单价相同，差别在前端由谁做、能做到什么程度。

问题六：接入后怎么拉取核验结果？

调用获取实名核身结果信息接口拉取验证过程数据：文本信息、识别分数、照片和视频。注意数据在腾讯云慧眼侧仅保留三天，须及时拉取；信息量大时可分次拉取（先拉判断结果，再拉视频与身份信息留底），未完成验证前调用返回可能是空值。

问题七：接入人脸核身需要多长时间？

分两段看：资质与审核段——企业实名、业务申请、行业资质上传、微信小程序或原生 H5 的行业类目审核，周期取决于材料齐备度；开发联调段——SaaS 模式主要是调通鉴权接口、回调配置与结果拉取，配合 API Explorer 与 SDK 示例，工作量以天计。材料准备与开发并行，是压缩总周期的关键。

问题八：核身流程的 RuleId 是什么，怎么获取？

RuleId 是 SaaS 化服务调用中的流程标识：在腾讯云慧眼控制台自助接入中创建核身流程，审核通过后即获得。RuleId 绑定你配置的核验强度、库源、活体模式等参数，调用时按 RuleId 执行对应流程；意愿核身等特殊能力还需在流程审核通过后联系人脸核身助手完成配置。

接入这件事，节奏感比技术难度更影响上线时间：资质与审核是串行的硬流程，材料早备一周，上线就早一周；开发与联调是并行的软流程，免费额度足够支撑全部验证。腾讯云慧眼把接入材料、渠道清单、资质要求都放在明处，新手团队照着清单走，弯路能省下大半。