Video y recursos

Actualizar activo de material

Actualiza un activo de material de Seedance propiedad de la organización actual.

PUT
/v1/videos/assets/{assetId}

Actualice asset_name o metadata; envíe al menos uno de ellos. La URL de origen y el tipo de activo no pueden cambiarse; cree un nuevo activo cuando cambie el archivo de origen.

Solo se puede actualizar un activo ACTIVE: un activo en estado PROCESSING devolverá un error 409 con seedance_material_preparing, y un activo FAILED devolverá un 422.

project_name delimita los recursos dentro de su organización y tiene como valor predeterminado default. Utilice el mismo valor (sensible a mayúsculas y minúsculas) para grupos y activos relacionados. Envíelo en el cuerpo JSON para POST/PUT y en la cadena de consulta para GET/DELETE.

Ejemplo de solicitud

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

Ejemplo de respuesta

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

Autorización

bearerAuth

Parámetros de ruta

assetId*string

ID de activo de material de TokenLab.

Cuerpo de la solicitud

application/json

Actualizar asset_name o metadatos. La URL de origen y el tipo de activo no se pueden cambiar; cree un nuevo activo en su lugar.

Propiedades1 <= properties

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json