查询素材

POST

/volc/asset/ListAssets

查询素材列表，支持按名称、素材组 ID、素材组类型过滤。查询操作不计费。

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "model": "volc-asset",
    "PageNumber": 1,
    "PageSize": 10,
    "Filter": {
        "Name": "test",
        "GroupType": "AIGC",
        "GroupIds": [
            "group-20260320141746-zsf6b"
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/volc/asset/ListAssets' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "volc-asset",
    "PageNumber": 1,
    "PageSize": 10,
    "Filter": {
        "Name": "test",
        "GroupType": "AIGC",
        "GroupIds": [
            "group-20260320141746-zsf6b"
        ]
    }
}'

Responses

🟢200

application/json

查询成功

Body

Example

{
    "PageNumber": 1,
    "PageSize": 1,
    "TotalCount": 2,
    "Items": [
        {
            "Id": "asset-20260320142452-2htjn",
            "Name": "test",
            "URL": "https://ark-media-asset.tos-cn-beijing.volces.com/...",
            "AssetType": "Image",
            "GroupId": "group-20260320141746-zsf6b",
            "Status": "Active",
            "ProjectName": "default",
            "CreateTime": "2026-03-20T14:24:52Z",
            "UpdateTime": "2026-03-20T14:25:01Z"
        }
    ]
}

🟠401

Modified at 2026-03-23 06:19:36

查询素材组

Error