建议每 3–5 秒查询一次，直到返回 HTTP 200。
请求参数
string
必填
CreateVisualValidateSession 返回的会话凭证。
string
可传
default 或不传。响应参数
string
认证成功生成的真人素材组 ID（
GroupType 为 LivenessFace）；认证未成功时为空字符串。{
"BytedToken": "2026102008000076196B0812040B53D1B8"
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"GroupId": "group-20261020080200-fghij"
}
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"GroupId": ""
}
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1",
"Error": {
"Code": "NotFound",
"Message": "The verification result is not available yet."
}
}
}
素材库
GetVisualValidateResult
查询活体认证结果，获取认证生成的真人素材组 ID。
{
"BytedToken": "2026102008000076196B0812040B53D1B8"
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"GroupId": "group-20261020080200-fghij"
}
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1"
},
"Result": {
"GroupId": ""
}
}
{
"ResponseMetadata": {
"RequestId": "20261020080000ABCDEF",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "ap-southeast-1",
"Error": {
"Code": "NotFound",
"Message": "The verification result is not available yet."
}
}
}