All Products
Search
Document Center

Intelligent Media Management:FigureClusterForReq

Last Updated:Oct 09, 2025
ParameterTypeDescriptionExample
object

The information for updating a face cluster.

ObjectIdstring

The ID of the face cluster.

Cluster-99b1c333-86dc-45da-8c6****
Namestring

The name of the cluster.

abc
Coverobject

The cover image.

Figuresarray<object>

The persons.

object

The person.

FigureIdstring

The person ID.

2cb3c51e-b406-4b0c-af1b-897d88e1****
CustomIdstring

The custom ID.

abc
CustomLabelsobject

The custom labels. You can search for the cluster by label.

{"Bucket": "examplebucket"}
MetaLockVersionlong

The version of the metadata lock. A metadata lock version can be obtained by using a get or list operation. If you include the MetaLockVersion parameter in a request to update the cluster, the server checks consistency between the MetaLockVersion parameter value sent in the request and the one on the server side and updates the cluster only when they are consistent. This parameter is used to prevent update conflicts in concurrent scenarios. The initial version is 0. The version is automatically increased by 1 after each successful update.

1