1. 真人认证
HBoom
  • 豆包
    • 视频生成
      • 创建视频生成任务(Seedance 2.0)
      • 查询视频生成任务列表
      • 查询单个视频生成任务
      • 删除视频生成任务
    • 素材分组
      • CreateAssetGroup 建素材分组(虚拟人像 AIGC)
      • DeleteAssetGroup 删除素材分组
      • GetAssetGroup 查询单个分组信息
      • UpdateAssetGroup 更新分组(名称/描述)
    • 素材
      • CreateAsset 入库素材(传 URL,异步)
      • GetAsset 查询素材状态(轮询)
      • ListAssets 列出素材(Filter 过滤)
      • UpdateAsset 更新素材(如备注名)
      • DeleteAsset 删除素材
    • 真人认证
      • CreateVisualValidateSession 发起真人 H5 认证
        POST
      • GetVisualValidateResult 换取真人 GroupId(通常平台内部自动调用)
        POST
  1. 真人认证

CreateVisualValidateSession 发起真人 H5 认证

POST
/v1/volc/ark/
真人人像建组入口。请求体留空即可。
CallbackURL 与 session_id 均由平台服务端生成(按你的访问域名),无需也不应传入;ProjectName 由平台按渠道强制注入。响应只回 H5Link + session_id,BytedToken 由后端持有不下发。
用户在 H5Link 完成人脸认证后,浏览器自动跳转完成建组。

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Query 参数

Body 参数application/json

示例
{}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v1/volc/ark/?Action=CreateVisualValidateSession&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

返回响应

🟢200
成功,返回 H5Link + session_id
该响应没有 Body
修改于 2026-06-23 11:14:56
上一页
DeleteAsset 删除素材
下一页
GetVisualValidateResult 换取真人 GroupId(通常平台内部自动调用)
Built with