获取真人认证结果

正式环境

https://api.naoshengyun.com

POST

/v1/video/liveness-results

查询认证结果。认证尚未完成时，当前响应中的 GroupId 为空字符串；认证成功后返回或复用真人素材组 ID。
成功或失败的终态 Token 会被消费，不能再次查询。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
    "BytedToken": "token-1",
    "ProjectName": "default"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.naoshengyun.com/v1/video/liveness-results' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "BytedToken": "token-1",
    "ProjectName": "default"
}'

返回响应

🟢200

application/json

查询成功

Bodyapplication/json

示例

{
    "Result": {
        "GroupId": "group-1"
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🔴500InternalError

🔴502BadGateway

修改于 2026-10-08 05:51:42

创建真人认证会话

创建素材组