更新資產組

可用性

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

注意

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

端點

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

身份驗證

使用 Modelflare API 金鑰：

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

請求

重新命名現有資產組。

場	類型	必填	說明	範例
Id	string	是	資產組 ID。	group-20260320141746-zsf6b
Name	string	否	新群組名稱。	updated-project-assets
model	string	否	計費模型。預設為 volc-asset。	volc-asset

JSON 範例：

JSON

{
  "model": "volc-asset",
  "Id": "group-20260320141746-zsf6b",
  "Name": "updated-project-assets"
}

cURL 範例：

bash

curl --request POST https://modelflare.dev/volc/asset/UpdateAssetGroup \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Id": "group-20260320141746-zsf6b",
  "Name": "updated-project-assets"
}'

回應

請求成功。

場	類型	必填	說明	範例
Id	string	是	資產組 ID。	group-20260320141746-zsf6b
Name	string	是	更新了群組名稱。	updated-project-assets
UpdateTime	string	否	更新時間戳記。	2026-05-28T06:09:31Z

回應範例：

JSON

{
  "Id": "group-20260320141746-zsf6b",
  "Name": "updated-project-assets",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

錯誤

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

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

JSON

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

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