> ## Documentation Index
> Fetch the complete documentation index at: https://docs-vip.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GetVisualValidateResult

> 查询活体认证结果，获取认证生成的真人素材组 ID。

```text theme={null}
POST {BaseUrl}/?Action=GetVisualValidateResult&Version=2024-01-01
Content-Type: application/json
```

请求需使用 HMAC-SHA256 签名，见[鉴权与通用约定](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/asset-overview.md#鉴权)。

| 结果 | 返回 |
| - | - |
| 尚未完成认证 | HTTP 404，`Code` 为 `NotFound`，稍后重查 |
| 认证成功 | HTTP 200，`Result.GroupId` 为真人素材组 ID |
| 认证失败、超时或会话过期 | HTTP 200，`Result.GroupId` 为空字符串，需重新创建会话 |

建议每 3–5 秒查询一次，直到返回 HTTP 200。

## 请求参数

**BytedToken** `string` *required*

[CreateVisualValidateSession](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/create-visual-validate-session.md) 返回的会话凭证。

**ProjectName** `string`

可传 `default` 或不传。

## 响应参数

**Result.GroupId** `string`

认证成功生成的真人素材组 ID（`GroupType` 为 `LivenessFace`）；认证未成功时为空字符串。

```json 请求体 theme={null}
{
  "BytedToken": "2026102008000076196B0812040B53D1B8"
}
```

```json 认证成功 theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": "group-20261020080200-fghij"
  }
}
```

```json 认证未成功 theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "GroupId": ""
  }
}
```

```json 尚未完成 theme={null}
{
  "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."
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.