Create a human verification session

After creating a human liveness verification session, open H5Link in a mobile browser and save BytedToken. When capture is complete, the browser redirects to CallbackURL, but a successful callback does not mean the real-person asset group is ready.

Complete capture and retrieve the verification result within 10 minutes. If the session expires, create a new one instead of reusing an expired token.

POST/v1/assets/doubao/

Create a liveness verification session. Open H5Link in a mobile browser and save BytedToken to retrieve the final result.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

Action*"CreateVisualValidateSession"

Always CreateVisualValidateSession.

Default"CreateVisualValidateSession"

Value in

"CreateVisualValidateSession"

Version*"2024-01-01"

API version, always 2024-01-01.

Default"2024-01-01"

Value in

"2024-01-01"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

CallbackURL*string

Customer callback URL used after verification completes.

Formaturi

ProjectName?string

Managed by the platform. A supplied value is not used for business partitioning.

Response Body

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=CreateVisualValidateSession&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "https://example.com/liveness/callback"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807165225A641759",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "BytedToken": "202608071652256191D5DA0C813A641759",
    "H5Link": "https://example.com/mobile/liveness-face/authorization",
    "CallbackURL": "https://example.com/liveness/callback"
  }
}