# 创建真人认证会话

URL: http://localhost:3000/docs/zh-cn/api/asset-library/CreateVisualValidateSession

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



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

<ArkOperation>
  <div>
    ## 请求参数 [#请求参数]

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

    ## 响应参数 [#响应参数]

    `Result` 结构：

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

    ## 错误码 [#错误码]

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

    其余通用错误码见[素材库总览](/zh-cn/api/asset-library#错误码)。
  </div>

  <div>
    ## 在线调试 [#在线调试]

    <ArkTryIt method="POST" action="CreateVisualValidateSession" body="{ CallbackURL: 'https://your-server.example.com/liveness/callback', ProjectName: 'default' }" />

    ## 请求示例 [#请求示例]

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

    ## 响应示例 [#响应示例]

    ```json
    {
      "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"
      }
    }
    ```
  </div>
</ArkOperation>

## 官方文档 [#官方文档]

[拉起真人认证 H5（CreateVisualValidateSession）](https://docs.volcengine.com/docs/82379/2333587?lang=zh)