GetVisualValidateResult 换取真人 GroupId(通常平台内部自动调用)

POST

/v1/volc/ark

正常闭环由平台在 liveness/callback 内部用后端持有的 BytedToken 自动调用,并强制带 ProjectName(IAM 按 project 维度鉴权)。客户端一般无需手动调,此处仅为文档完整性保留。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

Query 参数

Body 参数application/json必填

示例

{
    "BytedToken": "byted-xxxx"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/volc/ark?Action=GetVisualValidateResult&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "BytedToken": "byted-xxxx"
}'

返回响应

🟢200成功

成功,返回真实 GroupId(平台翻译为 hbg-)

该响应没有 Body

修改于 2026-07-22 01:21:43

CreateVisualValidateSession 发起真人 H5 认证

CreateAsset 入库素材(传 URL,异步)