Get the visual validation result

Availability

This page documents the Modelflare asset-management route. Calls require a valid media API key, an available media channel, and the required permission.

Note

The gateway records provider asset IDs, status, and user ownership. The Castaly local library remains separate from the provider asset namespace.

Endpoint

POST https://modelflare.dev/volc/asset/GetVisualValidateResult

Authentication

Use a Modelflare API key:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Send Idempotency-Key with create, update, and delete requests. Retrying the same key for the same user replays the saved response without repeating the mutation.

Request

Query a visual validation session with the temporary token returned by CreateVisualValidateSession.

Field	Type	Required	Description	Example
BytedToken	string	Yes	Temporary token returned by the session-creation route.	2026070222152680501D985EA34A3BE3D8

JSON example:

JSON

{
  "BytedToken": "2026070222152680501D985EA34A3BE3D8"
}

cURL example:

bash

curl --request POST https://modelflare.dev/volc/asset/GetVisualValidateResult \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "BytedToken": "2026070222152680501D985EA34A3BE3D8"
}'

Response

The validation result was returned. GroupId can be empty while processing.

Field	Type	Required	Description	Example
GroupId	string	No	The liveness asset group ID after successful validation.	group-20260702221642-5czvq

Response example:

JSON

{
  "GroupId": "group-20260702221642-5czvq"
}

Errors

Status	Meaning
400	The request is invalid.
401	The API key is missing or unauthorized.
404	The temporary token does not exist.

Error body example (when returned):

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

Image, video, and audio creation are asynchronous. After receiving an asset ID, call GetAsset and use the asset://<ID> reference only when the status is Active.