取得資產

可用性

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

注意

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

端點

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

身份驗證

使用 Modelflare API 金鑰：

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

請求

透過 ID 讀取一項資產。使用此路由輪詢非同步上傳，直到 Status 為 Active 或 Failed。

場	類型	必填	說明	範例
Id	string	是	要查詢的資產ID。	asset-20260528140922-d9646

JSON 範例：

JSON

{
  "Id": "asset-20260528140922-d9646"
}

cURL 範例：

bash

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

回應

請求成功。

場	類型	必填	說明	範例
Id	string	是	資產 ID。	asset-20260528140922-d9646
Name	string	否	資產名稱。	character-reference
URL	string	否	臨時檔案 URL。記錄的使用壽命為 12 小時；請勿保留為產生參考。	https://example.com/temporary-asset
AssetType	Image	Video	Audio	否
GroupId	string	否	所屬組ID。	group-20260320141746-zsf6b
Status	Processing	Active	Failed	否
ProjectName	string	否	項目名稱。	default
CreateTime / UpdateTime	string	否	ISO 8601 時間戳記。	2026-05-28T06:09:31Z

回應範例：

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

錯誤

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

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

JSON

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

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