Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Person management

Prev Next

Available in VPC

Person management is a space where you can view and manage persons appearing in media assets through face‑centric cards. When analyzing a video, persons detected through face recognition are automatically registered in an anonymous state without names, and anonymous persons are also displayed as cards so you can assign names or merge them. All persons use a unique Person ID as the primary identifier, and names are optional.

View person list

You can view persons managed within the workspace in a face‑centric card grid. To view the person list:

  1. Access the Media Intelligence workspace.
  2. Select the [Person management] menu.

Person card

Each person is displayed in a card format, and the card consists of the following elements.

Item Description
Face thumbnail Representative image of the person. Anonymous persons also always display the detected face image.
Person ID Unique value assigned to the person. The person ID is displayed as the primary identifier on the card in the ID N format.
Name Name of the named person. If a person has no name, [+ Add name] is displayed.
Number of appearing assets. Number of assets in which the person appears (에셋 N개).

Status filter search sort.

At the top of the list, you can filter, search, and sort persons based on the following conditions.

Item Description
Status filter The [All]/[Named]/[Anonymous] filters are provided, and the number of persons in each status is displayed together.
Search Search by person name or person ID. Anonymous persons without a name can also be searched by their person ID.
Alignment Sort by number of assets (default), recently added, person ID, or person name.
Pagination A default of 24 items per page is displayed, and you can navigate using the page numbers.
Note

When you change the status filter, search, or sort conditions, the list moves back to the first page.

View persons in detail.

When you click a person card, a detail view panel appears on the right side of the interface where you can view the person’s detailed information. The detail view panel is for viewing only. To modify the person’s information, click [Edit] at the bottom of the panel (or [Assign name] for anonymous persons) to open the edit popup.

To view person details:

  1. Access the Media Intelligence workspace.
  2. Select the [Person management] menu.
  3. Click the person card you want to view from the person list.
  4. Check the person’s information in the detail view panel that appears on the right side of the interface.

The detail view panel displays information in the following order: similar persons → person image → appearance assets, and its structure is as follows.

Item Description
Header Person thumbnail, person ID (primary identifier), name or [+ Add name]
Similar persons It is displayed at the top only when merge candidates exist. Each candidate is shown with its image, ID (or name), and similarity score, along with the [Merge] option. (Refer to Person merge)
Person image List of images registered for the person. You can view up to 100 images by clicking [View more].
Appearance assets List of assets in which the person appears (N개 에셋 · 총 M장면). When you click an asset row, you are taken to the latest analysis index interface with the person search activated.
Action It is provided at the bottom of the panel. Named persons provide [Edit]/[Delete], while anonymous persons provide [Assign name]/[Delete]. Changes to person information (name, description, tags, and images) are made in the edit popup that appears when you click [Edit].
Note

The detail view panel is for viewing only. For changing person information, refer to Person edit, for assigning a name to an anonymous person, refer to Assign name to anonymous person, for merging similar persons, refer to Person merge.

Register person

To register a new person:

  1. Access the Media Intelligence workspace.
  2. Select the [Person management] menu.
  3. Click [Register person].
  4. Register the person information according to the following conditions:
Item Required Input condition Remarks
Person image Required
  • JPG, JPEG, PNG, and WEBP
  • Up to 5 MB per file
  • Minimum resolution of 256 px in width and height
Representative image is required. Up to 100 images can be uploaded.
Person name Optional Up to 50 characters If left empty, it is registered in the anonymous (unnamed) state.
Person description Optional Up to 700 characters -
Person tag Optional Up to 30 -
  1. Click [Register].
Note
  • Uploaded images automatically detect and lock only the face component.
  • Upload fails if the image lacks a face component or is unclear. Register files with clear, front-facing faces.
  • Registered images display both the representative image (★) and the automatically extracted images from videos (⚡), and are sorted in the order of representative → manually registered → automatically extracted. By clicking a thumbnail, you can set or delete the representative image.

Auto-recommend similar people

A list of recommended people automatically appears when you set a representative image if similar people are already registered.

  • Up to three recommended persons with a similarity of 80% or higher are presented, and you can select one of them.
  • When the representative image is changed, the recommendation list is updated, and recommendations are shown only in registration mode (they are not shown in edit mode).
  • When you select the [Merge persons], person registration is stopped and the entry is merged into the existing person. Newly registered person images are automatically included in the existing person’s images.

Assign name to anonymous person

To assign a name to an anonymous person who does not have one:

  1. Click the anonymous person card in the person list.
  2. In the detail view panel, click [Assign name].
  3. Enter a name and then save.
    • When name assignment is completed, only the label is updated in the same grid position, and the counts of named/anonymous items in the status filter are automatically reflected.

Person merge

To merge similar persons that are determined to be the same individual:

  1. Click the person card to be merged in the person list.
  2. In the detail view panel, click [Merge] for the target person in the similar persons list at the top.
  3. When the person merge confirmation popup appears, review the details and proceed.
    • When the merge is completed, the detail view panel closes and a completion message is displayed.

Edit person

To edit person information:

  1. Click the person card to be edited in the person list.
  2. In the detail view panel, click [Edit].
  3. When the person edit popup appears with the existing information prefilled, modify the person details and click [Save].

Delete person

To delete person information:

Caution
  • When a specific person is deleted, all labeled information in the index is reset and changed to anonymous.
  • Deleting person information cannot be undone.
  1. Click the person card to be deleted in the person list.
  2. In the detail view panel, click [Delete].