# 查询真人活体认证结果

用 POST /v1/asset-groups/validate-session 返回的 BytedToken 轮询认证结果。BytedToken 有效期 120 秒，建议 5 秒间隔轮询直到状态终态或超时。

第三方 SaaS：创建会话时传的 `external_user_id` 不会跟到这个接口。body 里必须再传同一个值，成功时组才会绑到该 end-user。完整说明见 [素材库 · external_user_id](/docs/asset-library#external-user-id)。

状态终态有三种：
- 成功：响应体含 `GroupId` 字段 + `status: "active"`，对应的真人组已绑定到当前用户
- 失败：响应体含 `ResponseMetadata.Error`
- 还未完成：响应体无 `GroupId`，继续轮询即可

## POST /v1/asset-groups/validate-result

> 查询真人活体认证结果

用 POST /v1/asset-groups/validate-session 返回的 BytedToken 轮询认证结果。BytedToken 有效期 120 秒，建议 5 秒间隔轮询直到状态终态或超时。

状态终态有三种：
- 成功：响应体含 `GroupId` 字段 + `status: "active"`，对应的真人组已绑定到当前用户
- 失败：响应体含 `ResponseMetadata.Error`
- 还未完成：响应体无 `GroupId`，继续轮询即可

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **bytedToken** `string` **(required)**  
  从 validate-session 响应中获得的 BytedToken。
- **model** `string`  
  可选。命中 explicit relay 渠道 (如 doubao-seedance-2-0-pro) 时,
- **external_user_id** `string`  
  第三方 SaaS 终端用户标识符（opaque 字符串，≤128 字符，可选）。设了之后, 写入的 GroupId 会绑定到 (api_user, external_user_id)，后续 list / get / update / delete 必须传**同一个** external_user_id 才能看到。不传 = 老行为（API key 持有者直接拥有，单租户）。

### Response

- **GroupId** `string`  
  成功时返回的新真人素材组 ID，已自动绑定到当前用户账户。
- **status** ``active``  
  成功时固定为 `active`。
- **ResponseMetadata** `object`  
  失败或仍在处理中时返回 Ark 上游元数据。
- **Result** `object`  
  仍在处理中时为空对象。

### Error Codes

- `400`: 
- `401`: 
- `403`: 权限不足
- `502`: