# 查询真人活体认证结果

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

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

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

> Poll a real-person liveness verification result

Poll the liveness verification result using the BytedToken returned by POST /v1/asset-groups/validate-session. The BytedToken is valid for 120 seconds; poll at 5-second intervals until a terminal state or timeout.

There are three terminal states:
- Success: the response body contains a `GroupId` field and `status: "active"` — the real-person group has been bound to the current user account.
- Failure: the response body contains `ResponseMetadata.Error`.
- Still in progress: the response body has no `GroupId` — continue polling.

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **bytedToken** `string` **(required)**  
  The BytedToken obtained from the validate-session response.
- **external_user_id** `string`  
  Optional third-party SaaS end-user identifier (opaque, ≤128 chars). When set, the resulting GroupId is bound to (api_user, external_user_id) so subsequent list / get / update / delete must pass the **same** external_user_id to see it. Omit for legacy single-tenant behaviour (the API key holder owns everything).
- **model** `string`  
  Optional. When it resolves to an explicit relay channel (e.g. doubao-seedance-2-0-pro),

### Response

- **GroupId** `string`  
  The newly created real-person asset group ID, automatically bound to the current user account. Present only on success.
- **status** ``active``  
  Fixed value `active` on success.
- **ResponseMetadata** `object`  
  Upstream Ark metadata returned when the result is a failure or still in progress.
- **Result** `object`  
  Empty object when verification is still in progress.

### Error Codes

- `400`: 
- `401`: 
- `403`: Insufficient permissions
- `502`: