TokenLab

視頻與素材

更新素材資產

更新當前組織擁有的 Seedance 素材資產。

PUT
/v1/videos/assets/{assetId}

更新 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}

授權

bearerAuth

路徑參數

assetId*string

TokenLab 素材資產 ID。

請求主體

application/json

更新 asset_name 或元資料。來源 URL 和資源類型無法變更;請改為建立新資源。

屬性1 <= properties

回應

application/json

application/json

application/json

application/json

application/json

application/json

application/json