Skip to main content
PUT
更新 Seedance 素材資產
更新素材名稱或元數據(metadata)。來源 URL 和資源類型在建立後即固定;若來源檔案有所變更,請建立一個新的資源。 project_name 用於同一組織內的資源隔離,預設為 default。相關素材群組和素材須使用相同且區分大小寫的值;POST/PUT 在 JSON 請求主體中傳入,GET/DELETE 在查詢參數中傳入。

請求範例

回應範例

路徑參數

assetId
string
必填

TokenLab 素材資產 ID。

主體

application/json
asset_url
string<uri>

替換後的公開可存取素材資源 URL。

asset_name
string

儲存於素材資源中的更新後顯示名稱。

Required string length: 1 - 128
asset_type
enum<string>
可用選項:
Image,
Video,
Audio
project_name
string
預設值:default
Required string length: 1 - 128
metadata
object | null

儲存於素材資源中的更新後客戶端元數據。

回應

素材資產已更新

id
string
必填

TokenLab 素材資源 ID。在資源變為 ACTIVE 後,請將此作為 material_asset_id 使用。

object
enum<string>
必填
可用選項:
seedance.material_asset
library_type
enum<string>
必填
可用選項:
aigc_avatar,
liveness_face
asset_type
enum<string>
必填
可用選項:
Image,
Video,
Audio
status
enum<string>
必填
可用選項:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
必填

當資源為啟用且未刪除時為 True。

group_id
string | null

擁有此素材資源的 TokenLab 素材群組 ID。

project_name
string

此素材資源的專案範圍。

asset_name
string | null
error_message
string | null

可公開顯示的終端處理錯誤。永久性來源驗證失敗包含被拒絕的尺寸限制。

metadata
object | null
created_at
integer

建立素材資源記錄時的 Unix 時間戳記。

updated_at
integer

最後更新素材資源記錄時的 Unix 時間戳記。