建立資產組

可用性

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

端點

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

身份驗證

使用 Modelflare API 金鑰：

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

請求

為 Seedance 工作流程所使用的圖像、視訊和音訊資源建立一個群組。

場	類型	必填	說明	範例
`Name`	`string`	是	資產組的名稱。	`my-project-assets`
`model`	`string`	否	計費模型。預設為 `volc-asset`。	`volc-asset`

JSON 範例：

{
  "Name": "my-project-assets",
  "model": "volc-asset"
}

cURL 範例：

curl --request POST https://modelflare.dev/volc/asset/CreateAssetGroup \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Name": "my-project-assets",
  "model": "volc-asset"
}'

回應

該組已建立。

場	類型	必填	說明	範例
`Id`	`string`	是	新資產組 ID。	`group-20260320141746-zsf6b`

回應範例：

{
  "Id": "group-20260320120601-hsw4s"
}

錯誤

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

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

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

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