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. Each account can create up to 100 virtual (AIGC) asset groups and 100 liveness (LivenessFace) asset groups (200 in total; contact us if you need a higher limit). Each group can upload up to 1 million assets. For asset upload limits, see Create asset.

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.

Request URL

POST

https://api.gravitex.ai/api/v3/seedance?Action=CreateVisualValidateSession&Version=2024-01-01

Query Parameters

string

required

Action name, fixed as CreateVisualValidateSession

string

required

Version, fixed as 2024-01-01

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

Request example

curl -X POST "https://api.gravitex.ai/api/v3/seedance?Action=CreateVisualValidateSession&Version=2024-01-01" \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{}'

Response example

{
  "BytedToken": "202607...",
  "H5Link": "https://www.byteplus.com/en/liveness-face-manage/authorization?pl=...",
  "CallbackURL": "https://api.gravitex.ai/asset-validate-callback.html"
}

Field	Description
`H5Link`	Show to end users to complete live person validation (open in WebView/browser)
`BytedToken`	Save on the client side; valid for 30 minutes, single use; call GetVisualValidateResult after completion to obtain `GroupId`
`CallbackURL`	Fallback display page after validation; does not affect active polling with `BytedToken`

Live person asset restrictions

Quota：Each account can create up to 100 virtual (AIGC) asset groups and 100 liveness (LivenessFace) asset groups (200 in total; contact us if you need a higher limit). Each group can upload up to 1 million assets. For asset upload limits, see Create asset
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

API documentation

Chat & text

Safety & audio

Image Series

Video Series

Completions & Embeddings

Interface module

Create asset group (liveness) (CreateVisualValidateSession)

Introduction

Request URL

Query Parameters

Authentication

Request parameters

Request example

Response example

Live person asset restrictions

​Introduction

​Request URL

​Query Parameters

​Authentication

​Request parameters

​Request example

​Response example

​Live person asset restrictions

Introduction

Request URL

Query Parameters

Authentication

Request parameters

Request example

Response example

Live person asset restrictions