> ## 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.

# CreateVisualValidateSession

> Create a liveness verification session and get the H5 link for the person to scan their face.

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

Requests must be signed with HMAC-SHA256. See [Authentication and conventions](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/asset-overview.md#authentication).

* Give the returned `H5Link` to the person, who opens it in a mobile browser and completes the face scan. `H5Link` is valid for about 2–3 minutes; use it right after creation.
* When verification ends, the browser is redirected to `CallbackURL`. The authoritative result comes from [GetVisualValidateResult](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/get-visual-validate-result.md).
* Each `BytedToken` can be verified only once and is valid for 30 minutes. A successful verification creates a new real-person asset group. See [Real-person assets](https://docs-vip.apigo.ai/en/api-reference/endpoints/seedance/asset-overview.md#real-person-assets) for the full flow.

## Request parameters

**CallbackURL** `string` *required*

HTTP(S) URL the browser is redirected to when verification ends.

**ProjectName** `string`

Pass `default` or omit.

## Response parameters

**Result.BytedToken** `string`

Session token used to query the verification result.

**Result.H5Link** `string`

URL of the face verification page.

**Result.CallbackURL** `string`

The redirect URL passed in the request.

```json Request body theme={null}
{
  "CallbackURL": "https://www.example.com/liveness/done"
}
```

```json 200 theme={null}
{
  "ResponseMetadata": {
    "RequestId": "20261020080000ABCDEF",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "ap-southeast-1"
  },
  "Result": {
    "BytedToken": "2026102008000076196B0812040B53D1B8",
    "H5Link": "https://h5.example.com/liveness?token=2026102008000076196B0812040B53D1B8",
    "CallbackURL": "https://www.example.com/liveness/done"
  }
}
```


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