创建真人认证会话

拉起端上 H5 真人（活体）认证会话。真人素材组通过此流程创建，认证完成后用 GetVisualValidateResult 取回素材组 ID。

拉起端上 H5 真人（活体）认证会话。真人素材组（LivenessFace）通过此流程创建。终端在返回的 H5Link 完成认证后会跳转到 CallbackURL（带上 bytedToken 与 resultCode），随后用该 BytedToken 调 GetVisualValidateResult 取回创建的素材组 ID。接入信息与鉴权见素材库总览。

请求参数

参数	类型	必填	说明
`CallbackURL`	string	是	认证完成后的回跳地址
`ProjectName`	string	否	资源所属项目，默认 `default`

响应参数

Result 结构：

字段	类型	说明
`BytedToken`	string	本次会话凭证，用于 `GetVisualValidateResult`
`H5Link`	string	端上活体认证页地址，有效期以上游为准
`CallbackURL`	string	回显请求传入的回跳地址

错误码

Code	说明
`MissingParameter.CallbackURL`	未传 `CallbackURL`
`AccessDenied`	无该项目成员权限
`OperationDenied.ServiceNotOpen`	租户未开通素材库能力

其余通用错误码见素材库总览。

在线调试

「发送」会用你填写的 AK/SK 向所选服务器发起真实调用，与生产请求等效、可能产生计费。

POSThttps://maas-ark.stringx.top/?Action=CreateVisualValidateSession&Version=2024-01-01

凭证Access Key IDSecret Access Key

RegionService

请求体（JSON）

请求示例

{
  "CallbackURL": "https://your-server.example.com/liveness/callback",
  "ProjectName": "default"
}

响应示例

{
  "ResponseMetadata": {
    "RequestId": "202603280000000000000000000000",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "BytedToken": "byted-xxxxxxxxxxxx",
    "H5Link": "https://h5.example.com/liveness?token=…",
    "CallbackURL": "https://your-server.example.com/liveness/callback"
  }
}

官方文档

拉起真人认证 H5（CreateVisualValidateSession）