真人素材认证流程

真人认证包含两个服务端 Action 和一次终端用户 H5 操作。最终应以服务端查询结果为准。

1. 创建认证会话

调用 CreateVisualValidateSession。由于界云兼容层不处理真实回调，CallbackURL 建议固定传入 https://callback.default。

响应包含：

• BytedToken：本次认证的唯一凭证，有效期 30 分钟且仅可认证一次。
• H5Link：交给终端用户打开的认证页面，使用后失效。
• CallbackURL：原样返回请求中携带的占位地址。

2. 打开 H5Link

将 H5Link 交给终端用户，并保存 BytedToken。需要指定页面语言时，可在 H5Link 后使用 lng 参数；支持 zh、en 和 zh-Hant。

3. 等待终端认证完成

界云兼容层不依赖 CallbackURL 接收认证结果。用户完成 H5 操作后，服务端应使用已保存的 BytedToken 主动查询，不要等待回调通知。

火山原始接口的 CallbackURL 参数和回调后缀说明，请查看 CreateVisualValidateSession 完整接口文档。

4. 获取真人素材组

终端完成认证后，调用 GetVisualValidateResult，传入保存的 BytedToken。

成功响应中的 GroupId 是本次认证创建的 LivenessFace 素材组 ID。认证尚未完成时，服务可能返回待处理错误；不要重复使用已经消费或过期的 BytedToken。