> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建素材组（真人）

> CreateVisualValidateSession — 发起真人核验会话

## 简介

发起 H5 真人核验会话。真人素材组（`GroupType = LivenessFace`）**不能**通过 `CreateAssetGroup` 创建（会被强制改写为 `AIGC`），只能走本流程。

与虚拟素材库共用同一套 Asset/AssetGroup Action；核验通过并拿到 `GroupId` 后，后续增删改查与 `AIGC` 完全一致。

<Warning>
  响应形状与其他 Action **不一样**：这是原始的**扁平结构**，不是 `{ResponseMetadata, Result}` 信封。
</Warning>

<Warning>
  配额检查发生在这一步：超限返回 `403`，`ResponseMetadata.Error.Code = "QuotaExceeded"`，不会生成 H5 核验链接。
</Warning>

## 认证

<ParamField header="Authorization" type="string" required>
  Bearer Token，如 `Bearer sk-your_token_key`
</ParamField>

## 请求参数

<ParamField body="CallbackURL" type="string">
  **无论传什么，都会强制改写为固定的回调页地址**——防止跳转到调用方指定的任意地址。`GetVisualValidateResult` 走带 Bearer 鉴权的同一 API，不依赖回调页传递上下文
</ParamField>

<ParamField body="ProjectName" type="string" default="default">
  项目名
</ParamField>

## 请求示例

```bash theme={null}
curl -X POST "https://api.gravitex.ai/api/v3/seedance?Action=CreateVisualValidateSession&Version=2024-01-01" \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## 响应示例

```json theme={null}
{
  "BytedToken": "202607...",
  "H5Link": "https://www.byteplus.com/en/liveness-face-manage/authorization?pl=...",
  "CallbackURL": "https://api.gravitex.ai/asset-validate-callback.html"
}
```

| 字段            | 说明                                                                                                                                            |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `H5Link`      | 展示给终端用户完成真人核验（建议 WebView/浏览器打开）                                                                                                               |
| `BytedToken`  | 调用方自行保存，30 分钟内有效、只能核验一次；完成后用它调用 [GetVisualValidateResult](/cn/api-reference/endpoint/seedance-2.0-new/get-visual-validate-result) 换 `GroupId` |
| `CallbackURL` | 核验完成后的兜底展示页，不影响用 `BytedToken` 主动轮询结果                                                                                                          |

## 真人素材额外限制

* **配额独立**：每个用户在每个渠道下的真人素材组数量单独限额（与 `AIGC` 分开计算）
* **人脸匹配**：每个真人素材组对应唯一真实人物；上传素材会与核验参考人脸比对，不匹配或多张人脸会导致 `Status: Failed`
* **删除限制**：见 [DeleteAssetGroup](/cn/api-reference/endpoint/seedance-2.0-new/delete-asset-group)