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

ListAssets 列出素材(Filter 过滤)

POST
/v1/volc/ark/
按官方实测结构:过滤条件统一放进 Filter 对象,GroupIds 为字符串数组(平台 hbg- id),平台会逐元素翻译。顶层 GroupId 不被识别(会报 MissingParameter.Filter)。
GroupType:真人用 LivenessFace,虚拟用 AIGC。Statuses 支持 Active/Processing/Failed。Name 支持模糊搜索。

请求参数

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

Body 参数application/json必填

示例
{
    "Filter": {
        "GroupIds": [
            "hbg-3V1lztXLe9Wzj399OyLm"
        ],
        "GroupType": "LivenessFace",
        "Statuses": [
            "Active",
            "Processing"
        ],
        "Name": "figure"
    },
    "PageNumber": 1,
    "PageSize": 10,
    "SortBy": "GroupId",
    "SortOrder": "Asc"
}

请求示例代码

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=ListAssets&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Filter": {
        "GroupIds": [
            "hbg-3V1lztXLe9Wzj399OyLm"
        ],
        "GroupType": "LivenessFace",
        "Statuses": [
            "Active",
            "Processing"
        ],
        "Name": "figure"
    },
    "PageNumber": 1,
    "PageSize": 10,
    "SortBy": "GroupId",
    "SortOrder": "Asc"
}'

返回响应

🟢200
application/json
成功。Items 内每条 Id/GroupId 均为平台脱敏后的 hb-/hbg-(火山真实 id 不外露)
Bodyapplication/json

示例
{
    "ResponseMetadata": {
        "Action": "ListAssets",
        "RequestId": "2026...",
        "Region": "cn-beijing",
        "Service": "ark",
        "Version": "2024-01-01"
    },
    "Result": {
        "Items": [
            {
                "AssetType": "Image",
                "CreateTime": "2026-06-22T07:31:37Z",
                "GroupId": "hbg-xxxxxxxx",
                "Id": "hb-yyyyyyyy",
                "Moderation": {
                    "Strategy": "Default"
                },
                "Name": "人脸照",
                "ProjectName": "hbkj",
                "Status": "Active",
                "URL": "",
                "UpdateTime": "2026-06-22T07:31:41Z"
            }
        ],
        "PageNumber": 1,
        "PageSize": 20,
        "TotalCount": 1
    }
}
修改于 2026-06-23 11:14:56
上一页
GetAsset 查询素材状态(轮询)
下一页
UpdateAsset 更新素材(如备注名)
Built with