創建視訊資源

可用性

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

端點

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

身份驗證

使用 Modelflare API 金鑰：

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

請求

將影片新增至現有群組。傳回的 ID 可以在處理後由支援的 Seedance 工作流程使用。

場	類型	必填	說明	範例
`GroupId`	`string`	是	目標資產組ID。	`group-20260320141746-zsf6b`
`AssetType`	`Video`	是	必須是`Video`。	`Video`
`URL`	`string`	是	公共影片 URL。不接受影片 Base64。使用 MP4 或 MOV，2–30 秒，24–60 FPS，每邊 300–6000 像素，0.4–2.5 寬高比，480p/720p/1080p/4K，總像素 407696–2086876，且不超過 2000 MB。	`https://example.com/video.mp4`
`file`	`binary`	否	具有相同視訊限制的 `URL` 的多部分替代方案。	`video.mp4`
`Name`	`string`	否	顯示/搜尋名稱，最多 64 個字元。	`scene-clip`
`model`	`string`	是		`volc-asset-video`
`ProjectName`	`string`	否	項目名稱。必須符合目標群體；預設為 `default`。	`default`

JSON 範例：

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

多部分/表單資料範例：

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

回應

影片已進入非同步處理。輪詢GetAsset，直到Status 為Active 或Failed。沒有上傳時 SLA；一個典型的影片大約需要 9 到 12 秒，而繁忙的審核隊列可能需要大約 10 秒到 2 分鐘。

場	類型	必填	說明	範例
`Id`	`string`	是	資產 ID。僅當狀態為`Active`後才可使用`asset://<ID>`。	`asset-20260528140922-d9646`

回應範例：

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

錯誤

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

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

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

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