TokenLab

Video & tư liệu

Cập nhật Material Asset

Cập nhật một Seedance material asset thuộc sở hữu của tổ chức hiện tại.

PUT
/v1/videos/assets/{assetId}

Cập nhật asset_name hoặc metadata; hãy gửi ít nhất một trong hai trường này. URL nguồn và loại asset không thể thay đổi; hãy tạo một asset mới khi tệp nguồn thay đổi.

Chỉ có thể cập nhật asset ở trạng thái ACTIVE: asset đang ở trạng thái PROCESSING sẽ trả về lỗi 409 với mã seedance_material_preparing, và asset ở trạng thái FAILED sẽ trả về lỗi 422.

project_name phân loại các tài nguyên trong tổ chức của bạn và mặc định là default. Hãy sử dụng cùng một giá trị phân biệt chữ hoa chữ thường cho các nhóm và asset liên quan. Gửi giá trị này trong phần thân JSON cho các yêu cầu POST/PUT và trong chuỗi truy vấn (query string) cho các yêu cầu GET/DELETE.

Ví dụ yêu cầu

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"}'

Ví dụ phản hồi

{
  "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}

Xác thực

bearerAuth

Tham số đường dẫn

assetId*string

ID tài nguyên vật liệu TokenLab.

Nội dung yêu cầu

application/json

Cập nhật asset_name hoặc metadata. URL nguồn và loại tài sản không thể thay đổi; hãy tạo tài sản mới thay thế.

Thuộc tính1 <= properties

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json