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

# 프리셋

> 재사용 가능한 렌더 구성 관리

프리셋은 배경, 자막 스타일, 레이아웃, 기타 시각적 설정 등 재사용 가능한 렌더 구성으로, 어떤 프로젝트나 내보내기에도 적용할 수 있습니다. 프리셋은 여러 트랙에 걸쳐 일관된 룩을 유지해야 할 때 이상적입니다.

`preset`의 전체 형태와 enum 기반 옵션을 모두 보려면 [Render settings reference](/en/render-settings-reference)를 확인하세요.

## `preset schema`

프리셋 설정에 대한 JSON Schema를 반환합니다. 프리셋을 생성하거나 업데이트하기 전에 유효한 필드를 확인하는 데 사용하세요.

```bash theme={null}
youka preset schema --json
```

<Tip>
  에이전트는 프리셋을 변경하기 전에 `preset schema`를 호출해 정확한 필드명과 값 타입을 알아야 합니다.
</Tip>

## `preset list`

인증된 계정이 소유한 모든 프리셋을 나열합니다.

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

## `preset show`

ID로 단일 프리셋을 가져옵니다.

```bash theme={null}
youka preset show <presetId> --json
```

## `preset create`

새 프리셋을 생성합니다.

```bash theme={null}
youka preset create [options]
```

### Options

| Option             | Description                  |
| ------------------ | ---------------------------- |
| `--name <name>`    | 프리셋 이름                       |
| `--default`        | 새 프리셋을 기본값으로 표시              |
| `--body <file\|->` | 파일 또는 stdin에서 전체 요청 본문을 읽습니다 |

<Note>
  요청 본문에는 전체 `preset` 객체가 포함되어야 합니다. 페이로드가 큰 경우 인라인 JSON 대신 `--body`를 사용하는 것을 권장합니다.
</Note>

### Examples

<CodeGroup>
  ```bash from-file theme={null}
  youka preset create \
    --name "Neon Night" \
    --body ./neon-preset.json \
    --json
  ```

  ```bash make-default theme={null}
  youka preset create \
    --name "Red Cinema" \
    --body ./red-cinema.json \
    --default \
    --json
  ```

  ```bash from-stdin theme={null}
  cat ./preset.json | youka preset create --name "From stdin" --body - --json
  ```
</CodeGroup>

CLI 플래그는 `--body`의 동일한 필드를 덮어씁니다.

## `preset update`

기존 프리셋을 업데이트합니다.

```bash theme={null}
youka preset update <presetId> [options]
```

| Option             | Description            |
| ------------------ | ---------------------- |
| `--name <name>`    | 새 이름                   |
| `--body <file\|->` | 파일 또는 stdin에서 전체 요청 본문 |

Example:

```bash theme={null}
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json
```

## `preset delete`

ID로 프리셋을 삭제합니다.

```bash theme={null}
youka preset delete <presetId> --json
```

<Warning>
  프리셋을 삭제해도 이전에 해당 프리셋으로 렌더링된 프로젝트나 내보내기는 삭제되지 않습니다. 삭제된 프리셋을 참조하는 이후 내보내기는 실패합니다.
</Warning>

## `preset default`

기본 프리셋을 가져오거나 설정합니다.

```bash theme={null}
youka preset default --json
youka preset default <presetId> --json
```

인자가 없으면 현재 기본 프리셋 또는 `null`을 반환합니다. 프리셋 ID를 제공하면 해당 프리셋을 기본값으로 설정합니다.

## 프리셋 적용

`--preset`으로 프로젝트 또는 내보내기에 프리셋을 적용합니다:

<CodeGroup>
  ```bash on-create theme={null}
  youka project create ./song.mp3 --preset $PRESET_ID --wait
  ```

  ```bash on-settings-update theme={null}
  youka project settings $PROJECT_ID --preset $PRESET_ID
  ```

  ```bash on-export theme={null}
  youka export create $PROJECT_ID --preset $PRESET_ID --wait
  ```
</CodeGroup>

## 다음 단계

* [Render settings reference](/en/render-settings-reference) - 공유되는 모든 프리셋 필드
* [Projects](/ko/cli/projects) - 프로젝트 설정에 프리셋 적용
* [Exports](/ko/cli/exports) - 렌더 시점에 프리셋 적용
* [Media](/ko/cli/media) - 프리셋에서 참조하는 재사용 가능한 미디어