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

> 创建真人活体认证会话，获取供真人刷脸的 H5 链接。

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

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

* 将返回的 `H5Link` 交给本人在手机浏览器中打开并完成刷脸。`H5Link` 有效期约 2–3 分钟，请在创建后立即使用。
* 认证结束后浏览器跳转到 `CallbackURL`。认证结果以 [GetVisualValidateResult](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/get-visual-validate-result.md) 为准。
* 每个 `BytedToken` 只能认证一次，有效期 30 分钟。认证成功会生成一个新的真人素材组，完整流程见[真人素材](https://docs-vip.apigo.ai/api-reference/endpoints/seedance/asset-overview.md#真人素材)。

## 请求参数

**CallbackURL** `string` *required*

认证结束后浏览器跳转的 HTTP(S) 地址。

**ProjectName** `string`

可传 `default` 或不传。

## 响应参数

**Result.BytedToken** `string`

认证会话凭证，用于查询认证结果。

**Result.H5Link** `string`

刷脸认证页面地址。

**Result.CallbackURL** `string`

请求中传入的回跳地址。

```json 请求体 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.