視頻與素材
更新素材資產
更新當前組織擁有的 Seedance 素材資產。
更新 asset_name 或 metadata;請至少發送其中一項。來源 URL 和資產類型無法更改;若來源檔案有變更,請建立新的資產。
僅能更新 ACTIVE 狀態的資產:若資產為 PROCESSING 狀態,將回傳 409 並顯示 seedance_material_preparing;若資產為 FAILED 狀態,則回傳 422。
project_name 用於劃定組織內的資源範圍,預設值為 default。請針對相關群組與資產使用相同且區分大小寫的值。在 POST/PUT 請求中請將其放入 JSON 本文中,在 GET/DELETE 請求中則放入查詢字串中。
請求範例
curl https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr \
-X PUT \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_name":"Front view approved","metadata":{"approved_by":"creative-team"},"project_name":"default"}'回應範例
{
"id": "asset-20260720123456-qn7wr",
"object": "seedance.material_asset",
"project_name": "default",
"group_id": "group-20260720123456-vrt01",
"library_type": "aigc_avatar",
"asset_name": "Front view approved",
"asset_type": "Image",
"status": "ACTIVE",
"ready": true,
"error_message": null,
"metadata": {"approved_by": "creative-team"},
"created_at": 1782998400000,
"updated_at": 1782998400000
}curl -X PUT "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr" \ -H "Content-Type: application/json" \ -d '{ "asset_name": "Front view approved", "metadata": { "approved_by": "creative-team" } }'{ "id": "asset-20260720123456-qn7wr", "object": "seedance.material_asset", "group_id": "group-20260720123456-vrt01", "library_type": "aigc_avatar", "asset_name": "Front view approved", "asset_type": "Image", "status": "ACTIVE", "ready": true, "error_message": null, "metadata": { "approved_by": "creative-team" }, "created_at": 1782998400000}