> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 미디어

> 재사용 가능한 이미지, 비디오, 로고, 인트로/아웃트로 클립을 업로드하고 관리합니다

미디어는 프리셋 또는 프로젝트 설정에서 참조할 수 있는 재사용 가능한 파일입니다. 한 번 업로드한 뒤 여러 프로젝트와 내보내기에 걸쳐 적용할 수 있습니다.

## `media add`

로컬 파일을 재사용 가능한 미디어로 업로드합니다.

```bash theme={null}
youka media add <file> --as <type>
```

<ParamField path="file" type="string" required>
  업로드하려는 파일의 로컬 경로입니다.
</ParamField>

<ParamField path="--as" type="string" required>
  `image`, `video`, `logo`, `intro`, `outro` 중 하나입니다.
</ParamField>

### Types

| Type    | Description  |
| ------- | ------------ |
| `image` | 정적 배경 이미지    |
| `video` | 반복 재생 배경 비디오 |
| `logo`  | 오버레이 로고      |
| `intro` | 인트로 클립       |
| `outro` | 아웃트로 클립      |

### Examples

<CodeGroup>
  ```bash image theme={null}
  youka media add ./background.png --as image --json
  ```

  ```bash intro theme={null}
  youka media add ./intro.mp4 --as intro --json
  ```
</CodeGroup>

## `media list`

인증된 계정에 업로드된 미디어 목록을 표시합니다.

```bash theme={null}
youka media list
youka media list --json
```

## `media show`

ID로 미디어 항목 하나를 가져옵니다.

```bash theme={null}
youka media show <mediaId>
youka media show <mediaId> --json
```

## `media delete`

업로드된 미디어 항목을 삭제합니다.

```bash theme={null}
youka media delete <mediaId> --json
```

<Warning>
  미디어를 삭제해도 기존 프로젝트나 내보내기가 다시 작성되지는 않습니다. 해당 미디어를 참조하는 향후 렌더링만 방지합니다.
</Warning>

## 다음 단계

* [Presets](/ko/cli/presets) - 미디어를 재사용 가능한 렌더 설정으로 묶기
* [Projects](/ko/cli/projects) - `project settings`을 통해 미디어 적용하기