列出資產

可用性

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

注意

網關記錄提供者資產 ID、狀態和使用者所有權。 Castaly 本機庫與提供者資產命名空間保持分離。

端點

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

身份驗證

使用 Modelflare API 金鑰：

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

發送帶有建立、更新和刪除請求的 Idempotency-Key。對同一用戶重試相同的金鑰會重播已儲存的回應，而不會重複突變。

請求

列出具有可選名稱、群組和群組類型篩選器的資產。在 Seedance 請求中使用 ID 之前，請等待 Status: Active。

場	類型	必填	說明	範例
model	string	是	計費模型。預設為 volc-asset。	volc-asset
Filter.Name	string	否	模糊資產名稱過濾器。	character
Filter.GroupIds	string[]	否	按組 ID 過濾。	["group-20260320141746-zsf6b"]
Filter.GroupType	AIGC	LivenessFace	否	依組類型過濾。
PageNumber	integer	否	頁碼。預設為 1。	1
PageSize	integer	否	每頁的項目。預設為 10。	10

JSON 範例：

JSON

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

cURL 範例：

bash

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

回應

請求成功。

場	類型	必填	說明	範例
Items[]	object[]	否	具有身分、類型、群組、狀態、項目和時間戳記的資產對象。	{ Id, Name, AssetType, GroupId, Status, ... }
Items[].Id / Name	string	否	資產識別和顯示名稱。	asset-20260528140922-d9646 / character-reference
Items[].AssetType / GroupId	string	否	資產類型和所屬組。	Image / group-20260320141746-zsf6b
Items[].Status / ProjectName	string	否	處理狀態與項目名稱。	Active / default
Items[].CreateTime / UpdateTime	string	否	ISO 8601 建立和更新時間戳記。	2026-03-20T14:25:01Z
Items[].URL	string	否	臨時檔案 URL。記錄的使用壽命為 12 小時；使用 asset://<ID> 產生請求。	https://example.com/temporary-asset
Items[].Error	object	否	當Status為Failed時，Code和Message處理錯誤。	{ Code, Message }
PageNumber	integer	否	傳回的頁碼。	1
PageSize	integer	否	傳回的頁面大小。	10
TotalCount	integer	否	總匹配資產。	2

回應範例：

JSON

{
  "Items": [
    {
      "Id": "asset-20260528140922-d9646",
      "Name": "character-reference",
      "AssetType": "Image",
      "GroupId": "group-20260320141746-zsf6b",
      "Status": "Active",
      "ProjectName": "default"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

錯誤

狀態	意義
400	請求無效。
401	API 金鑰遺失或未經授權。

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

JSON

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

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