v1

latestOpenAPI 3.1.02026-07-224941145.6 KB

Create Visual Validate Session

Create a mobile liveness face validation session. Open the returned H5Link on a phone to complete face verification. This endpoint requires an API token created with the Byteplus-Direct group.

post/volc/asset/CreateVisualValidateSession

Request body

CallbackURLstring

Optional callback URL to receive upstream validation events.

Example request

{
  "CallbackURL": "https://example.com/callback"
}

Response

Validation session created

BytedTokenstring

Temporary validation token. Use it with GetVisualValidateResult after the user completes liveness verification.

CallbackURLstring

Callback URL from the request.

H5Linkstring

Mobile H5 page URL for liveness face verification.

Example response

{
  "BytedToken": "2026070222152680501D985EA34A3BE3D8",
  "CallbackURL": "https://example.com/callback",
  "H5Link": "https://www.byteplus.com/en/liveness-face-manage/authorization?pl=..."
}