真人认证与素材管理概述

本文档描述真人认证及人像素材管理能力。 该能力专门用于拉起 H5 真人认证页，并在认证通过后查询或管理本次创建的真人人像素材组（GroupId）及对应素材。

关于具体的操作 API 列表，请参考左侧各独立接口文档。

典型调用流程

1. 会话创建：业务端向 EasyRouter 发起 POST /sessions 请求，传入回调地址，获取会话 ID (session_id)、byted_token 以及真人认证的页面跳转链接 h5_link。
2. 终端跳转：引导终端用户拉起真人认证页面。
3. 完成认证：终端用户完成人脸核验后，页面重定向跳转至配置的 callback_url。
4. 获取回调参数：解析出关键凭证 bytedToken 及结果状态码 resultCode。
5. 查询 GroupId：当 resultCode=10000（认证成功）时，通过 GET /sessions/:session_id 向 EasyRouter 查询并拉取生成的真人人像素材组 group_id。
6. 素材管理：获取 group_id 后，即可调用具体接口进行列表检索、素材上传、删除等相关管理动作。

回调处理说明

当终端用户完成认证后，重定向跳转的 callback_url 将附加如下结构参数：

https://easyrouter.io/v1/callback?bytedToken=202603311449168C23BA26**************&resultCode=10000&algorithmBaseRespCode=0&reqMeasureInfoValue=1&verify_type=real_time

解析重点：

• bytedToken：唯一会话标识。
• resultCode：当且仅当 resultCode 值为 10000 时，表示核验认证通过。

特殊说明：在视频生成接口中使用真人人像素材

在视频生成接口中使用已经成功上传并处于 Active 状态的真人人像素材时，可通过 asset://{asset_id} 协议路径格式引用。目前仅支持 dreamina-seedance-2-0 和 dreamina-seedance-2-0-fast 使用这个功能。

接口请求示例

• 请求路径：POST https://easyrouter.io/v1/video/generations

请求参数 (Body)

{
  "model": "dreamina-seedance-2-0",
  "prompt": "图片中的我，穿着宇航服在月球表面漫步，背景是璀璨的星空",
  "duration": 5,
  "metadata": {
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "asset://asset-20260520153701-pgxsl"
        }
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "seed": 42
  }
}

更多关于该视频模型生成的高级操作和调用细节，请跳转并参考： dreamina-seedance-2-0 视频生成模型说明文档