---
title: "미디어 에셋 관리"
slug: "maiu-mediaasset"
tags: ["Media AI Understanding"]
updated: 2026-09-17T09:07:57Z
published: 2026-09-17T09:07:57Z
canonical: "guide.ncloud-docs.com/maiu-mediaasset"
---

> ## 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 환경에서 이용 가능합니다.

미디어 에셋은 미디어 분석을 위해 준비된 파일로, 프로젝트에 등록되어 분석 및 관리 단위가 되는 영상 또는 이미지 파일입니다. 프로젝트에 미디어 에셋을 추가하여 영상 또는 이미지를 분석하고 분석 결과를 조회할 수 있습니다.

## 미디어 에셋 조회

프로젝트 내 에셋 목록 화면에서 미디어 에셋의 상태를 확인하고 관리할 수 있습니다. 미디어 에셋을 조회하는 방법은 다음과 같습니다.

1. Media Intelligence 워크스페이스에 접속해 주십시오.
2. 프로젝트명을 클릭해 주십시오.
3. 에셋 목록에서 조회할 미디어 에셋 행을 클릭해 주십시오.
4. 우측 패널의 **[기본 정보]** 탭 메뉴를 클릭해 주십시오.
5. **[인덱스 목록]** 탭 메뉴를 클릭한 후, 상세 정보를 확인해 주십시오.

### 상단 툴바

에셋 목록 상단에는 다음과 같은 툴바가 제공됩니다.

| 항목 | 표시 조건 | 설명 |
| --- | --- | --- |
| **[분석 시작]** 버튼 | 에셋 1개 이상 선택 시 | 분석 옵션 설정 창 표시, [인덱싱](/docs/maiu-analysis) 참조 |
| **[이동]** 버튼 | 에셋 1개 이상 선택 시 | 이동할 프로젝트 선택 메뉴 표시 |
| **[삭제]** 버튼 | 에셋 1개 이상 선택 시 | 삭제 확인 창 표시 |
| 검색창 | 항상 표시 | 에셋명 또는 에셋 ID 입력 후 **[Enter]** 키를 누르면 검색 결과 화면으로 전환 |

### 상태 필터 칩

에셋 목록 상단의 상태 필터 칩을 사용하여 인덱싱 및 장면 요약 진행 현황을 빠르게 확인할 수 있습니다. 각 칩에는 해당 조건에 해당하는 에셋 건수가 괄호로 표시됩니다.

| 필터 칩 | 포함 조건 | 비고 |
| --- | --- | --- |
| 전체 | 모든 에셋 | 기본값 |
| 대기 중 | 인덱싱 상태 = 대기 |  |
| 진행 중 | 인덱싱 진행 중 또는 장면 요약 진행 중 | 어느 한쪽이라도 진행이면 포함 |
| 인덱싱 완료 | 인덱싱 = 완료 |  |
| 장면 요약 완료 | 장면 요약 = 완료 |  |
| 분석 실패 | 인덱싱 또는 장면 요약 중 하나라도 실패 |  |
| 미분석 | 인덱싱, 장면 요약 모두 미실행 |  |

### 테이블 컬럼

에셋 목록 테이블의 컬럼 구성은 다음과 같습니다.

| 항목 | 설명 |
| --- | --- |
| 체크 박스 | 에셋 선택, 헤더 체크 박스로 전체 선택/해제 가능, 인덱싱 대기 중 또는 진행 중인 에셋 선택 불가 |
| 에셋 유형 | 영상 또는 이미지 아이콘 표시 |
| 에셋 | 썸네일(48×32)과 파일명 |
| 에셋 ID | 에셋에 부여된 고유한 값 |
| 최종 수정 | 마지막 작업 일시와 작업자명 |
| 크기 | 원본 파일 용량 |
| 인덱싱 | 인덱싱 상태 아이콘과 문구, 해당 에셋의 가장 최근 인덱싱 실행 건 상태 표시 |
| 장면 요약 | 장면 요약 상태 아이콘과 문구, 해당 에셋에서 가장 최근 생성된 인덱스의 장면 요약 상태 표시 |

각 상태 아이콘 정의는 다음과 같습니다.

| 상태 | 인덱싱 | 장면 요약 |
| --- | --- | --- |
| 미실행 | 인덱싱 전 | 장면 요약 전 |
| 대기 | 인덱싱 대기 | 장면 요약 대기 |
| 진행 중 | 인덱싱 중 (스피너) | 장면 요약 중 |
| 완료 | 인덱싱 완료 | 장면 요약 완료 |
| 실패 | 인덱싱 실패 (호버 시 사유 툴팁) | 장면 요약 실패 |

### 에셋 행 클릭 시 우측 패널

에셋 목록에서 행을 클릭하면 우측에 상세 패널이 열립니다. 우측 패널은 **[기본 정보]** 탭과 **[인덱스 목록]** 탭으로 구성됩니다.

#### 인덱스 목록 탭

해당 에셋의 인덱스 목록을 확인하고 인덱싱 및 장면 요약을 관리할 수 있습니다.

- **미분석 에셋**: 빈 상태 화면에 인덱싱 시작 버튼이 노출됩니다.
- **인덱싱 대기/진행 중**: 가상 카드가 표시되며, **[취소]** 버튼으로 인덱싱을 취소할 수 있습니다.
- **인덱싱 실패**: 가상 카드에 실패 사유와 **[다시 시도]** 버튼이 제공됩니다.
- **인덱싱 완료**: 완료된 인덱스 카드가 목록에 표시됩니다. 인덱스 카드에서 장면 요약 실행, 취소, 재시도를 직접 수행할 수 있습니다.

#### 기본 정보 탭

에셋의 기본 정보를 확인할 수 있습니다.

## 미디어 에셋 추가

미디어 에셋을 추가하는 방법은 다음과 같습니다.

1. Media Intelligence 워크스페이스에 접속해 주십시오.
  - [워크스페이스 접속](/docs/maiu-workspace) 참조
2. 프로젝트명을 클릭해 주십시오.
3. **[파일 추가]** 버튼을 클릭해 주십시오.
  - 미디어 에셋을 한 번도 추가한 적이 없는 프로젝트인 경우, **[연동 버킷에서 파일 선택하기]** 버튼을 클릭해 주십시오.
4. 분석 파일 추가 창에서 분석할 파일을 선택해 주십시오.
  - Workspaces 메뉴에서 연동한 Object Storage 버킷 내 파일 목록이 나타납니다.
  - 파일 목록에 작업할 분석 파일이 없는 경우, **[콘솔에서 연동 버킷 확인하기]** 버튼을 클릭한 후 Object Storage 메뉴에서 작업할 파일을 업로드해 주십시오.
  - 분석 파일 업로드 조건은 다음과 같습니다. 조건에 만족하는 파일만 목록에 노출됩니다.

| 항목 | 지원 사양 |
| --- | --- |
| 파일 형식 | - 영상: `*.mp4`, `*.mkv`, `*.mov`, `*.webm` - 이미지: `*.jpg`, `*.png`, `*.heic` |
| 파일 용량 | - 영상: 최대 10 GB - 이미지: 최대 10 MB |
5. **선택 파일** 영역에 분석할 파일이 추가되었는지 확인해 주십시오.
  - 한 번에 최대 10개의 파일을 추가할 수 있습니다.
  - 동일한 이름의 파일을 다시 추가하는 경우, 중복된 이름으로 추가됩니다. 중복된 이름으로 추가된 파일은 에셋 ID로 구분됩니다.
6. **[확인]** 버튼을 클릭해 주십시오.

주의

Object Storage 콘솔에서는 최대 1 GB 파일까지만 업로드할 수 있습니다. 1 GB를 초과하는 파일을 업로드하려면 Object Storage API 또는 S3 Browser를 사용해 주십시오.

- [Object Storage 콘솔 사용 가이드](/docs/objectstorage-use-file)
- [Object Storage API 가이드](https://api.ncloud-docs.com/docs/storage-objectstorage)
- [S3 Browser를 활용한 파일 업로드 가이드](https://www.ncloud.com/support/faq/all/1394)

참고

- 분석 가능한 영상의 해상도는 360p~1080p, 영상 시간은 최대 6시간으로 제한됩니다. 또한 분석 가능한 이미지의 해상도는 최소 360p, 최대 1080p로 제한됩니다. 조건을 만족하지 않는 영상과 이미지는 분석이 시작되지 않습니다.
- 저해상도로 변환하여 저장된 파일은 영상 분석 용도로만 이용하며, 엔진 학습 및 고도화를 위한 데이터로 활용되지 않습니다.
- 지원 가능한 파일 형식은 단계적으로 확대될 예정입니다.

## 미디어 에셋 이동

미디어 에셋을 다른 프로젝트로 이동하는 방법은 다음과 같습니다.

1. Media Intelligence 워크스페이스에 접속해 주십시오.
  - [워크스페이스 접속](/docs/maiu-workspace) 참조
2. 이동할 미디어 에셋의 체크 박스를 클릭해 주십시오.
  - 화면 상단에 **[이동]** 버튼이 나타납니다.
3. **[이동]** 버튼을 클릭해 주십시오.
4. 이동할 프로젝트 이름을 클릭해 주십시오.
5. 프로젝트 이름을 선택하면 활성화되는 **[이동]** 버튼을 클릭해 주십시오.

## 미디어 에셋 삭제

미디어 에셋을 삭제하는 방법은 다음과 같습니다.

1. Media Intelligence 워크스페이스에 접속해 주십시오.
  - [워크스페이스 접속](/docs/maiu-workspace) 참조
2. 삭제할 미디어 에셋의 체크 박스를 클릭하여 선택해 주십시오.
  - 화면 상단에 **[삭제]** 버튼이 나타납니다.
3. **[삭제]** 버튼을 클릭해 주십시오.
4. **미디어 에셋 삭제** 팝업 창이 나타나면 **[삭제]** 버튼을 클릭해 주십시오.

주의

미디어 에셋을 삭제하면 해당 미디어 에셋에 연결된 인덱스도 모두 삭제됩니다.