列出資產組

可用性

此頁面記錄了 Modelflare 資產管理路線。通話需要有效的智慧 API 金鑰或媒體群組 API 金鑰、可用的媒體頻道以及所需的權限。

端點

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

身份驗證

使用 Modelflare API 金鑰：

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

發送帶有建立、更新和刪除請求的 Idempotency-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`	否	群組標識和顯示名稱。	`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 金鑰遺失或未經授權。

錯誤主體範例（返回時）：

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

影像、視訊和音訊創建是非同步的。收到資產ID後，僅當狀態為Active時，呼叫GetAsset並使用asset://<ID>引用。