Skip to main content
POST
Create asset group (liveness) (CreateVisualValidateSession)

Introduction

Start an H5 live person validation session. Live person asset groups (GroupType = LivenessFace) cannot be created via CreateAssetGroup (which is always forced to AIGC); they must use this flow. Live person and virtual asset libraries share the same Asset/AssetGroup Actions; after validation succeeds and you receive GroupId, subsequent CRUD operations are identical to AIGC.
The response shape differs from other Actions: this returns a flat structure, not the {ResponseMetadata, Result} envelope.
Quota check happens at this step: exceeding the limit returns 403 with ResponseMetadata.Error.Code = "QuotaExceeded" and no H5 validation link is generated.

Authentication

string
required
Bearer Token, e.g. Bearer sk-your_token_key

Request parameters

string
Always forced to a fixed callback page URL regardless of inputโ€”preventing redirects to arbitrary caller-specified addresses. GetVisualValidateResult uses the same Bearer-authenticated API and does not rely on the callback page to pass context
string
default:"default"
Project name

Request example

Response example

Live person asset restrictions

  • Separate quota: live person asset group count per user per channel is limited independently (separate from AIGC)
  • Face matching: each live person asset group maps to one real person; uploaded assets are compared to the validation reference faceโ€”mismatch or multiple faces cause Status: Failed
  • Delete restrictions: see DeleteAssetGroup