Skip to main content
POST
创建素材组(真人)

简介

真人素材库(group_type: liveness_face不能通过 创建素材组 直接创建,须先在本接口发起 H5 真人核验,用户完成核验后网关落库素材组。 同一用户下虚拟组与真人组各最多 100 个,配额独立。核验通过后向该组追加图/视/音素材与虚拟库相同,走 创建素材不再触发人脸比对(首次创建组时仍以真人正脸完成核验)。
火山方舟 CreateVisualValidateSession 本身不接受 name / description;网关在拿到上游 GroupId 后会立刻调用 UpdateAssetGroup 将这两个字段回写到火山控制台。

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx
string
application/json

请求参数

string
必填
素材组名称(用于落库并回写火山方舟控制台)
string
描述;省略或空串时用 API Key 所属用户 username 兜底(与 创建素材组 一致)
integer
上游渠道 ID,省略则自动选择

H5 核验流程

业务侧无需直接调用 POST /v1/visual-validate/resultstate 由网关内置回调页自动转发。

请求示例

响应示例

客户端通常只需在 popup 中打开 h5_link 并监听 window.message。H5 超时后请关闭 popup、移除监听,并重新 POST /v1/visual-validate/session 获取新链接;建议在客户端设置约 130s 超时兜底。

客户端 postMessage

回调页(/asset-validate-callback.html)向 window.opener 投递消息(targetOrigin = '*')。回调页与主页若不同源,建议通过 type 字段识别,而非仅依赖 event.origin 核验成功:
核验失败:
最小集成示例:

后续步骤

  1. 使用返回的 group_id(来自 postMessage,本接口同步响应)调用 创建素材
  2. 轮询 列出素材查询单个素材 直至 status: active
  3. 创建视频生成任务 中用 asset:// 引用素材
也可用 列出素材组?group_type=liveness_face)确认组已创建。