---
title: "인물 관리"
slug: "maiu-person"
updated: 2026-09-17T09:07:57Z
published: 2026-09-17T09:07:57Z
canonical: "guide.ncloud-docs.com/maiu-person"
---

> ## 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.

# 인물 관리

VPC 환경에서 이용 가능합니다.

인물 관리는 미디어 에셋에 등장하는 인물을 얼굴 중심 카드로 조회하고 관리하는 공간입니다. 영상 분석 시 얼굴 인식으로 탐지된 인물은 이름이 없는 익명 상태로 자동 등록되며, 익명 인물도 카드로 노출되어 이름을 지정하거나 병합할 수 있습니다. 모든 인물은 고유한 **인물 ID** 를 주 식별자로 사용하며, 이름은 선택 항목입니다.

## 인물 목록 조회

워크스페이스 내 관리 중인 인물을 얼굴 중심 카드 그리드로 조회합니다. 인물 목록 조회 방법은 다음과 같습니다.

1. Media Intelligence 워크스페이스에 접속해 주십시오.
  - 워크스페이스 접속 방법은 [워크스페이스 접속](/docs/maiu-workspace) 가이드를 참조해 주십시오.
2. **[인물 관리]** 메뉴를 선택해 주십시오.

### 인물 카드

각 인물은 카드 형태로 표시되며, 카드 구성은 다음과 같습니다.

| 항목 | 설명 |
| --- | --- |
| 얼굴 썸네일 | 인물의 대표 이미지. 익명 인물도 탐지된 얼굴 이미지가 항상 표시 |
| 인물 ID | 인물에 부여된 고유한 값. 카드의 주 식별자로 'ID N' 형태로 표시 |
| 이름 | 명명된 인물의 이름. 이름이 없는 익명 인물은 **[+ 이름 추가]** 표시 |
| 등장 에셋 수 | 해당 인물이 등장하는 에셋 수('에셋 N개') |

### 상태 필터·검색·정렬

목록 상단에서 다음 조건으로 인물을 필터링·검색·정렬할 수 있습니다.

| 항목 | 설명 |
| --- | --- |
| 상태 필터 | **[전체]**, **[명명]**, **[익명]** 필터를 제공하며 각 상태별 인물 수가 함께 표시 |
| 검색 | 인물명 또는 인물 ID로 검색. 이름이 없는 익명 인물도 ID로 검색할 수 있음 |
| 정렬 | 에셋 많은 순(기본), 최근 추가순, ID순, 이름순으로 정렬 |
| 페이지네이션 | 페이지당 기본 24개씩 표시되며 페이지 번호로 이동 |

참고

상태 필터·검색·정렬 조건을 변경하면 목록은 첫 페이지로 이동합니다.

## 인물 상세 조회

인물 카드를 클릭하면 화면 우측에 인물의 상세 정보를 확인할 수 있는 상세 조회 패널이 나타납니다. 상세 조회 패널은 조회 전용이며, 인물 정보를 변경하려면 패널 하단의 **[수정]** 버튼(익명 인물은 **[이름 지정]** 버튼)을 클릭하여 수정 팝업으로 진입합니다.

인물 상세 정보를 조회하는 방법은 다음과 같습니다.

1. Media Intelligence 워크스페이스에 접속해 주십시오.
  - [워크스페이스 접속](/docs/maiu-workspace) 참조
2. **[인물 관리]** 메뉴를 선택해 주십시오.
3. 인물 목록에서 조회할 인물 카드를 클릭해 주십시오.
4. 화면 우측에 나타난 상세 조회 패널에서 인물 정보를 확인해 주십시오.

상세 조회 패널은 유사 인물 → 인물 이미지 → 등장 에셋 순으로 표시되며, 구성은 다음과 같습니다.

| 항목 | 설명 |
| --- | --- |
| 헤더 | 인물 썸네일, 인물 ID(주 식별자), 이름 또는 **[+ 이름 추가]** 버튼 표시 |
| 유사 인물 | 각 후보의 이미지, ID(또는 이름), 유사도와 함께 **[병합]** 버튼 제공 - 병합 후보가 있는 경우에만 상단에 표시 - [인물 병합](/docs/maiu-person#%EC%9D%B8%EB%AC%BC%EB%B3%91%ED%95%A9) 참조 |
| 인물 이미지 | 인물에 등록된 이미지 목록 - **[더 보기]** 버튼을 클릭하여 최대 100장까지 확인 가능 |
| 등장 에셋 | 인물이 등장하는 에셋 목록('N개 에셋 · 총 M장면') - 에셋 행을 클릭하면 해당 인물 검색이 활성화된 상태로 최신 분석 인덱스 화면으로 이동 |
| 액션 | 패널 하단에 제공되는 인물 관리 버튼 - 명명 인물: **[수정]**, **[삭제]** 버튼 - 익명 인물: **[이름 지정]**, **[삭제]** 버튼 - **[수정]** 버튼 클릭 시 나타나는 수정 팝업에서 인물 정보(이름, 설명, 태그, 이미지) 변경 가능 |

참고

상세 조회 패널은 조회 전용입니다. 인물 정보 변경은 [인물 수정](/docs/maiu-person#%EC%9D%B8%EB%AC%BC%EC%88%98%EC%A0%95), 익명 인물의 이름 부여는 [익명 인물 이름 지정](/docs/maiu-person#%EC%9D%B5%EB%AA%85%EC%9D%B8%EB%AC%BC%EC%9D%B4%EB%A6%84%EC%A7%80%EC%A0%95), 유사 인물 병합은 [인물 병합](/docs/maiu-person#%EC%9D%B8%EB%AC%BC%EB%B3%91%ED%95%A9)을 참조해 주십시오.

## 인물 등록

새로운 인물을 등록하는 방법은 다음과 같습니다.

1. Media Intelligence 워크스페이스에 접속해 주십시오.
  - [워크스페이스 접속](/docs/maiu-workspace) 참조
2. **[인물 관리]** 메뉴를 선택해 주십시오.
3. **[인물 등록]** 버튼을 클릭해 주십시오.
4. 다음 조건을 참고하여 인물 정보를 등록해 주십시오.

| 항목 | 필수 여부 | 입력 조건 | 비고 |
| --- | --- | --- | --- |
| 인물 이미지 | 필수 | - `JPG`, `JPEG`, `PNG`, `WEBP` - 파일당 최대 5MB - 가로/세로 256px 이상 | 대표 이미지 설정 필수. 최대 100장까지 등록 가능 |
| 인물명 | 선택 | 최대 50자 | 미입력 시 익명(미명명) 상태로 등록 |
| 인물 설명 | 선택 | 최대 700자 | - |
| 인물 태그 | 선택 | 최대 30개 | - |

1. **[등록]** 버튼을 클릭해 주십시오.

참고

- 업로드한 이미지는 얼굴 영역만 자동으로 인식·고정됩니다.
- 업로드한 이미지에 얼굴 영역이 없거나 선명하지 않으면 등록에 실패합니다. 얼굴이 정면으로 선명하게 나온 파일을 등록해 주십시오.
- 등록 이미지에는 대표 이미지(★)와 영상에서 자동 추출된 이미지(⚡)가 함께 표시되며, 대표 → 수동 등록 → 자동 추출 순으로 정렬됩니다. 썸네일 클릭 시 대표 이미지 설정 또는 삭제할 수 있습니다.

### 유사 인물 자동 추천

인물 등록 시 대표 이미지를 지정하면, 기존 등록 인물 중 유사한 인물이 있을 경우 추천 인물 목록이 자동으로 노출됩니다.

- 추천 인물은 유사도 80% 이상인 인물 중 최대 3건까지 제시되며, 이 중 1건을 선택할 수 있습니다.
- 대표 이미지를 변경하면 추천 목록이 갱신되며, 추천은 등록 모드에서만 노출됩니다(수정 모드에서는 노출되지 않습니다).
- **[인물 합치기]** 버튼을 선택하면 인물 등록을 중지하고 기존 인물로 병합합니다. 새로 등록한 인물 이미지는 기존 인물 이미지에 자동으로 포함됩니다.

## 익명 인물 이름 지정

이름이 없는 익명 인물에 이름을 부여하는 방법은 다음과 같습니다.

1. 인물 목록에서 익명 인물 카드를 클릭해 주십시오.
2. 상세 조회 패널에서 **[이름 지정]** 버튼을 클릭해 주십시오.
3. 이름을 입력한 후 저장해 주십시오.
  - 이름 지정이 완료되면 같은 그리드 위치에서 라벨만 갱신되며, 상태 필터의 명명/익명 건수가 자동으로 반영됩니다.

## 인물 병합

동일 인물로 판단되는 유사 인물을 하나로 합치는 방법은 다음과 같습니다.

1. 인물 목록에서 병합할 인물 카드를 클릭해 주십시오.
2. 상세 조회 패널 상단의 유사 인물 목록에서 대상 인물의 **[병합]** 버튼을 클릭해 주십시오.
3. 인물 합치기 확인 팝업이 나타나면 내용을 확인한 후 진행해 주십시오.
  - 병합이 완료되면 상세 조회 패널이 닫히고 완료 안내가 표시됩니다.

## 인물 수정

인물 정보를 수정하는 방법은 다음과 같습니다.

1. 인물 목록에서 수정할 인물 카드를 클릭해 주십시오.
2. 상세 조회 패널에서 **[수정]** 버튼을 클릭해 주십시오.
3. 인물 수정 팝업창에 기존 정보가 채워진 상태로 나타나면 인물 정보를 변경한 후 **[저장]** 버튼을 클릭해 주십시오.

## 인물 삭제

인물 정보를 삭제하는 방법은 다음과 같습니다.

주의

- 특정 인물을 삭제하면 인덱스에서 라벨링한 정보는 모두 초기화되어 익명 상태로 전환됩니다.
- 인물 삭제 시 해당 인물의 얼굴 특징 정보도 함께 삭제되어 유사 인물 추천 대상에서 제외됩니다.
- 인물 삭제 작업은 취소할 수 없습니다.

1. 인물 목록에서 삭제할 인물 카드를 클릭해 주십시오.
2. 상세 조회 패널에서 **[삭제]** 버튼을 클릭해 주십시오.