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

# 录入真人形象素材

> 通过官方真人认证流程，为 Seedance 2.0 视频生成录入已授权真人形象素材。

当你需要在 Seedance 2.0 视频生成中使用已授权真人肖像时，使用真人形象素材录入流程。火山方舟官方中文文档将该流程称为**录入真人形象素材**，用于将已授权真人肖像素材加入可信素材库。

在 Anyfast 中，该流程对应 `LivenessFace` 素材组。你先创建移动端认证会话，授权人用手机完成真人认证，然后上传与本人一致的图片、视频或音频素材，并在 Seedance 2.0 请求中通过 `asset://<asset_id>` 使用。

<Info>
  官方中文术语包含**真人形象素材**、**真人认证**、**可信素材库**和**私域素材库**。Anyfast API 中保留 `LivenessFace` 作为素材组类型，因为这是认证流程返回的上游素材组类型。
</Info>

<Warning>
  录入真人形象素材必须使用选择了 **Byteplus-Direct** 分组的 API 令牌。普通 AIGC 素材分组仅支持 `GroupType: "AIGC"`，无法创建真人认证会话或 LivenessFace 真人素材。
</Warning>

## 适用场景

* 已获得真人肖像授权。
* 需要为 Seedance 2.0 视频生成复用真人肖像素材。
* 希望使用 `asset://<asset_id>` 引用已认证素材，而不是公开 URL。

## 工作流

<Steps>
  <Step title="创建认证会话">
    调用 `CreateVisualValidateSession` 获取 `H5Link` 和 `BytedToken`。

    ```bash cURL theme={null}
    curl https://www.anyfast.ai/volc/asset/CreateVisualValidateSession \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "CallbackURL": "https://example.com/callback"
      }'
    ```
  </Step>

  <Step title="让授权人在手机上完成认证">
    将返回的 `H5Link` 发给授权人。授权人在手机上打开链接并完成真人认证。
  </Step>

  <Step title="查询认证结果">
    认证完成后，使用 `BytedToken` 查询结果。认证成功会返回 `LivenessFace` 素材组的 `GroupId`。

    ```bash cURL theme={null}
    curl https://www.anyfast.ai/volc/asset/GetVisualValidateResult \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "BytedToken": "2026070222152680501D985EA34A3BE3D8"
      }'
    ```
  </Step>

  <Step title="上传本人一致的真人素材">
    将图片、视频或音频上传到返回的素材组。图片和视频会与认证本人做人脸一致性校验。

    ```bash cURL theme={null}
    curl https://www.anyfast.ai/volc/asset/CreateAsset \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "volc-asset",
        "GroupId": "group-20260702221642-5czvq",
        "Name": "portrait-front",
        "AssetType": "Image",
        "URL": "https://example.com/portrait.jpg"
      }'
    ```
  </Step>

  <Step title="在 Seedance 2.0 中使用素材">
    素材状态变为 `Active` 后，在对应的内容 URL 字段中传入 `asset://<asset_id>`。

    ```json theme={null}
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://asset-20260702223855-bdv2r"
      },
      "role": "reference_image"
    }
    ```
  </Step>
</Steps>

## 素材要求

请上传与认证本人一致、清晰可识别的素材。BytePlus 官方建议使用清晰的正面图片，以提高一致性校验通过率。

| 素材类型 | 支持格式                            | 限制                                     |
| ---- | ------------------------------- | -------------------------------------- |
| 图片   | JPEG, JPG, PNG, WebP, GIF, HEIC | 小于 30 MB，300-6000 px，宽高比 0.4-2.5       |
| 视频   | MP4, MOV                        | 不超过 50 MB，2-15 秒，24-60 FPS，宽高比 0.4-2.5 |
| 音频   | MP3, WAV                        | 不超过 15 MB，2-15 秒                       |

<Note>
  不支持将不同人的素材上传到同一个真人素材组。每次上传都会根据该素材组的认证本人做一致性校验。
</Note>

## 常见问题

| 现象                                | 含义                  | 处理方式                             |
| --------------------------------- | ------------------- | -------------------------------- |
| `GroupType must be one of [AIGC]` | 令牌路由到了普通 AIGC 素材分组。 | 创建选择了 **Byteplus-Direct** 分组的令牌。 |
| `FaceMismatch`                    | 上传素材的人脸与认证本人不一致。    | 上传同一人的清晰正面素材。                    |
| `GroupId` 为空                      | 认证未完成，或未生成素材组。      | 让授权人完成 H5 认证后再次查询。               |
| `asset group ... not found`       | 素材组属于其他令牌或账号。       | 使用创建认证会话时的同一个令牌。                 |

## 相关接口

<CardGroup cols={2}>
  <Card title="创建真人认证会话" icon="scan-face" href="/zh/api-reference/model-api/bytedance/volc-asset-create-visual-validate-session">
    创建移动端真人认证会话。
  </Card>

  <Card title="查询真人认证结果" icon="badge-check" href="/zh/api-reference/model-api/bytedance/volc-asset-get-visual-validate-result">
    查询认证会话创建的 LivenessFace 素材组。
  </Card>

  <Card title="创建素材" icon="upload" href="/zh/api-reference/model-api/bytedance/volc-asset-create-image">
    向认证后的素材组上传本人一致的图片素材。
  </Card>

  <Card title="Seedance 2.0 素材管理" icon="folder-open" href="/zh/guides/model-api/bytedance/volc-asset">
    管理素材组和可复用的 `asset://` 引用。
  </Card>
</CardGroup>

## 官方参考

参见火山方舟：[录入真人形象素材](https://www.volcengine.com/docs/82379/2315856?lang=zh)。