01 素材检索

POST

/open-api/standard/v2/asset/search

通过筛选条件查询素材信息

提示

当检索发生在素材组内时（即 collectionId 不为空时）：
会进行穿透子素材组搜索（能搜到儿子、孙子素材组里的素材）；

素材筛选条件详解：

筛选条件获取：查询筛选模板元数据

2. 筛选条件设置：

筛选类型解释：

标签多选类型：

日期类型：

特殊类型：

素材状态筛选：

📌

素材状态解释:
可使用：素材正常，筛选值为"0"
已失效：素材已失效，筛选值为"1"
即将失效：素材即将失效，筛选值为"3"
未生效：素材未生效，筛选值为"2"
即将生效：素材即将生效，筛选值为"4"

创建人筛选：

素材大小筛选：

素材创建时间筛选：

素材合成任务ID筛选：

审批状态筛选：

合规检测状态筛选：

素材文件类型筛选：

optionalMap筛选“或”类型解释：

请求参数

Header 参数

Body 参数application/json

示例

{
    "token": "9a83bbf6-85ef-4aba-b3c4-d7c6e591c8ed",
    "param": {
        "keywordList": [
            "素材"
        ],
        "assetIds": [],
        "collectionId": null,
        "sort": {
            "field": "default",
            "sort": "desc"
        },
        "filterMap": {
            "format": [
                1,
                26,
                2,
                46,
                44,
                3,
                4,
                27,
                49,
                53
            ]
        },
        "pageNum": 1,
        "pageSize": 20
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open-auth.tezign.com/open-api/standard/v2/asset/search' \
--header 'Access-token: db28c148-24c0-452d-80e9-c4797d991a22' \
--header 'Access-token;' \
--header 'Token-type: bearer' \
--header 'x-open-api-user: xxx@tezign.com' \
--header 'x-asm-prefer-tag: version-env-07' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "9a83bbf6-85ef-4aba-b3c4-d7c6e591c8ed",
    "param": {
        "keywordList": [
            "素材"
        ],
        "assetIds": [],
        "collectionId": null,
        "sort": {
            "field": "default",
            "sort": "desc"
        },
        "filterMap": {
            "format": [
                1,
                26,
                2,
                46,
                44,
                3,
                4,
                27,
                49,
                53
            ]
        },
        "pageNum": 1,
        "pageSize": 20
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": "43",
    "message": "ipsum in",
    "result": {
        "totalCount": 51,
        "list": [
            {
                "id": 65,
                "assetElementId": 87,
                "name": "法已果市转织第",
                "size": 86,
                "createTime": 527291255885,
                "createUserId": 18,
                "extension": "PNG",
                "thumbnailSrc": "consequat",
                "downloadUrl": "http://jpy.cv/zlow",
                "importUrl": "http://pidqq.mobi/vvcxt",
                "baseText": null,
                "downloadPermission": false,
                "extend": {
                    "duration": null,
                    "width": 80,
                    "height": 31
                },
                "assetElementList": null,
                "transformPreviewUrl": "http://lrkjygqdqs.pk/okgp"
            },
            {
                "id": 55,
                "assetElementId": 2,
                "name": "结题动八严",
                "size": 78,
                "createTime": 72113162674,
                "createUserId": 48,
                "extension": "JPG",
                "thumbnailSrc": "reprehenderit Lorem dolore",
                "downloadUrl": "http://bbsjrln.pw/omwwg",
                "importUrl": "http://bjzn.uy/ehrnugb",
                "baseText": null,
                "downloadPermission": true,
                "extend": {
                    "duration": null,
                    "width": 76,
                    "height": 39
                },
                "assetElementList": null,
                "transformPreviewUrl": "http://eqko.an/hjmsrlnjbj"
            }
        ]
    }
}

修改于 2025-09-26 04:59:32

素材动态格式及大小转换

02 查询素材详情