跳到主要内容

创建真人认证会话

POST /api/volc-user/visual-validate-sessions

生成由平台展示认证结果的 H5 链接。认证成功后自动生成 LivenessFace 素材组，通过 查询认证会话 获取 groupId。

鉴权说明

用户控制台接口，使用登录会话 Cookie，或请求头 Authorization: <access_token>。访问令牌由 生成访问令牌 获取，与模型调用使用的 sk- 密钥不同。

请求参数​

参数名类型必选说明
namestring必选认证成功后素材组的名称，去除首尾空白后不能为空
descriptionstring可选认证成功后素材组的描述

请求示例​

POST /api/volc-user/visual-validate-sessions
Authorization: <access_token>
Content-Type: application/json

{
  "name": "演员本人素材组",
  "description": "用于授权的视频生成"
}

响应字段（200）​

字段名类型说明
successboolean业务是否成功；HTTP 200 仍需检查此字段
messagestring提示信息，成功时为空字符串
dataobject成功时的响应数据
data.sessionIdstring平台认证会话 ID，用于查询认证结果
data.statusstringPending、Processing、Succeeded、Failed、Expired，见 接入流程
data.h5Linkstring仅在会话为 Pending 且未过期时返回；交给本人打开完成认证
data.expiresAtinteger认证链接过期时间，Unix 秒；当前会话有效期为创建后 120 秒
data.groupIdstring认证成功后生成的平台素材组 ID；无值时省略，查询时已删除的素材组也不再返回
data.resultCodestringH5 认证结果码，有值时返回；成功为 10000
data.errorCodestring错误码，有值时返回
data.errorMessagestring错误说明，有值时返回
data.createTimeinteger创建时间，Unix 秒
data.updateTimeinteger更新时间，Unix 秒

响应示例​

{
  "success": true,
  "message": "",
  "data": {
    "sessionId": "vvs-example",
    "status": "Pending",
    "expiresAt": 1792022520,
    "createTime": 1792022400,
    "updateTime": 1792022400,
    "h5Link": "https://example.com/visual-validate?token=example"
  }
}

JSON 参数直接放在请求体顶层，无需 body 包装。此模式不接收客户回调地址；需要认证后返回业务页面时，请使用 自定义回调模式。