查询素材组列表

状态

本文记录已接入的 Modelflare 素材管理接口。调用需要有效的媒体 API Key、可用媒体渠道和对应权限。

接口

POST https://modelflare.dev/volc/asset/ListAssetGroups

鉴权

使用 Modelflare API Key：

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

创建、更新和删除请求建议携带 Idempotency-Key。同一用户使用相同 Key 重试时，网关会重放已保存响应，不重复创建或删除。

请求

按名称、ID 和素材组类型筛选素材组列表。查询操作不产生生成计费。

字段	类型	必填	说明	示例
`model`	`string`	是	计费模型，默认值为 `volc-asset`。	`volc-asset`
`Filter.Name`	`string`	否	按名称模糊匹配。	`my-project`
`Filter.GroupIds`	`string[]`	否	按素材组 ID 列表精确筛选。	`["group-20260320141746-zsf6b"]`
`Filter.Id`	`string`	否	按单个素材组 ID 精确筛选。	`group-20260320141746-zsf6b`
`Filter.GroupType`	`AIGC`	`LivenessFace`	否	按素材组类型筛选。
`PageNumber`	`integer`	否	页码，默认值为 `1`。	`1`
`PageSize`	`integer`	否	每页数量，默认值为 `10`。	`10`

JSON 示例：

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

cURL 示例：

curl --request POST https://modelflare.dev/volc/asset/ListAssetGroups \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "my-project",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}'

响应

请求成功。

字段	类型	必填	说明	示例
`Items[]`	`object[]`	否	包含 `Id`、`Name`、`GroupType` 和 `Status` 的素材组对象。	`{ Id, Name, GroupType, Status }`
`Items[].Id / Name`	`string`	否	素材组 ID 和展示名称。	`group-20260320141746-zsf6b / my-project-assets`
`Items[].GroupType / Status`	`string`	否	素材组类型和当前状态。	`AIGC / Active`
`PageNumber`	`integer`	否	返回页码。	`1`
`PageSize`	`integer`	否	返回每页数量。	`10`
`TotalCount`	`integer`	否	匹配的素材组总数。	`1`

响应示例：

{
  "Items": [
    {
      "Id": "group-20260320141746-zsf6b",
      "Name": "my-project-assets",
      "GroupType": "AIGC",
      "Status": "Active"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

错误

状态码	含义
`400`	请求参数无效。
`401`	API Key 缺失或未授权。

错误体示例（接口返回时）：

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

创建图片、视频和音频是异步的：收到素材 ID 后，先调用 GetAsset，只有 Active 状态才能把它放进 Seedance 的 asset://<ID> 引用。