素材一覧照会

素材をグループ ID リスト・グループタイプ・素材名あいまい・ステータスで絞り込みページ照会します。pageNo は 1 から、pageSize は最大 999999。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Header Parameters

X-Realperson-Model*string

指定该请求使用的真人认证渠道对应的模型名称，用于路由到正确的第三方账户配置

Request Body

application/json

pageNo?integer

页码（从 1 开始）

Formatint32

pageSize?integer

每页行数

Formatint32

groupIds?array<string>

素材组 ID 列表，按 ID 精确查询，不传则不过滤

groupType?string

素材组类型，可选值：AIGC（虚拟人像素材库）、LivenessFace（真人素材库）

Value in"AIGC" | "LivenessFace"

assetName?string

素材名称模糊搜索关键字，最长 64 个字符，不传则不过滤

statuses?array<string>

素材状态列表，不传则不过滤

Response Body

application/json

curl -X POST "https://www.aivve.cn/v1/aicc/asset/query" \
  -H "X-Realperson-Model: string" \
  -H "Content-Type: application/json" \
  -d '{
    "pageNo": 1,
    "pageSize": 10,
    "groupType": "AIGC"
  }'

curl -X POST "https://www.aivve.cn/v1/aicc/asset/query" \  -H "X-Realperson-Model: string" \  -H "Content-Type: application/json" \  -d '{    "pageNo": 1,    "pageSize": 10,    "groupType": "AIGC"  }'

{
  "requestId": "1803ae665a704fbd90d20b3d50085033",
  "state": "OK",
  "errorCode": "",
  "errorMessage": "",
  "body": {
    "data": [
      {
        "assetId": "volcano-asset-xxx",
        "groupId": "volcano-group-xxx",
        "assetName": "产品介绍视频",
        "assetType": "Video",
        "assetUrl": "https://example.com/asset.mp4?sign=xxx",
        "status": "ACTIVE",
        "errorMessage": "",
        "createdTime": "2026-04-11 12:00:00",
        "updatedTime": "2026-04-11 12:00:00"
      }
    ],
    "total": 1
  }
}

{
  "requestId": "string",
  "state": "ERROR",
  "errorCode": "C400002",
  "errorMessage": "PARAM_MISSING",
  "body": {}
}

素材一覧照会

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

application/json

application/json