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 ********************

API Key

在 header 添加参数

x-api-key

示例：

x-api-key: ********************

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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-07-22 01:21:43

GetAsset 查询素材状态(轮询)