# 获取真人认证结果

URL: http://localhost:3000/docs/zh-cn/api/asset-library/GetVisualValidateResult

用 BytedToken 取回真人认证创建的素材组 ID。



用 [CreateVisualValidateSession](/zh-cn/api/asset-library/CreateVisualValidateSession) 返回的 `BytedToken` 取回本次真人认证创建的素材组 ID。接入信息与鉴权见[素材库总览](/zh-cn/api/asset-library)。

<ArkOperation>
  <div>
    ## 请求参数 [#请求参数]

    | 参数            | 类型     | 必填 | 说明                  |
    | ------------- | ------ | -- | ------------------- |
    | `BytedToken`  | string | 是  | 真人认证会话凭证            |
    | `ProjectName` | string | 否  | 资源所属项目，默认 `default` |

    ## 响应参数 [#响应参数]

    `Result` 结构：

    | 字段        | 类型     | 说明                      |
    | --------- | ------ | ----------------------- |
    | `GroupId` | string | 认证创建的素材组 Id（形如 `grp_…`） |

    ## 错误码 [#错误码]

    | Code                          | 说明                          |
    | ----------------------------- | --------------------------- |
    | `MissingParameter.BytedToken` | 未传 `BytedToken`             |
    | `NotFound.byted_token`        | `BytedToken` 无效、已失效或不属于当前项目 |
    | `AccessDenied`                | 无该项目成员权限                    |

    其余通用错误码见[素材库总览](/zh-cn/api/asset-library#错误码)。
  </div>

  <div>
    ## 在线调试 [#在线调试]

    <ArkTryIt method="POST" action="GetVisualValidateResult" body="{ BytedToken: 'byted-xxxxxxxxxxxx', ProjectName: 'default' }" />

    ## 请求示例 [#请求示例]

    ```json
    {
      "BytedToken": "byted-xxxxxxxxxxxx",
      "ProjectName": "default"
    }
    ```

    ## 响应示例 [#响应示例]

    ```json
    {
      "ResponseMetadata": {
        "RequestId": "202603280000000000000000000000",
        "Action": "GetVisualValidateResult",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
      },
      "Result": {
        "GroupId": "grp_0a1b2c3d4e5f"
      }
    }
    ```
  </div>
</ArkOperation>

## 官方文档 [#官方文档]

[获取真人 Asset Group ID（GetVisualValidateResult）](https://docs.volcengine.com/docs/82379/2333588?lang=zh)