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

# 내보내기

> 클라우드 또는 로컬 머신에서 가라오케 내보내기를 렌더링하고 다운로드합니다

내보내기는 프로젝트에서 생성되는 렌더링된 아티팩트입니다. 기본적으로 내보내기는 클라우드에서 실행됩니다. 로컬 Remotion 파이프라인으로 자신의 머신에서 렌더링하려면 `--local`을 전달하세요.

## `export create`

프로젝트에 대한 새 내보내기를 렌더링합니다.

```bash theme={null}
youka export create <projectId> [options]
```

<ParamField path="projectId" type="string" required>
  내보낼 프로젝트입니다.
</ParamField>

### Options

| Option                  | Description                      |
| ----------------------- | -------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, 또는 `4k` |
| `--quality <value>`     | `low`, `medium`, 또는 `high`       |
| `--speed <number>`      | 재생 속도 배수                         |
| `--tone <number>`       | 피치 시프트 배수                        |
| `--transparent`         | 투명한 배경으로 렌더링                     |
| `--preset <presetId>`   | 이 내보내기에 대한 프리셋 재정의               |
| `--volume <stem=value>` | 타입별 스템 볼륨 설정. 반복 가능              |
| `--local`               | 클라우드 대신 로컬에서 렌더링                 |
| `--download`            | 내보내기가 완료될 때까지 기다린 뒤 다운로드         |
| `--output <path>`       | 로컬 렌더 또는 다운로드를 위한 출력 파일/디렉터리 경로  |

### Stem volumes

`--volume <type>=<value>`를 사용하세요. 유효한 타입은 `original`, `vocals`, `instrumental`, `backing_vocals`입니다. 값은 `0`에서 `1` 사이여야 합니다.

### Cloud render

```bash theme={null}
youka export create $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --wait \
  --download \
  --output ./karaoke.mp4 \
  --json
```

### Local render

로컬 렌더링은 사용자의 머신에서 Remotion 파이프라인을 실행합니다. 먼저 렌더 의존성이 설치되어 있는지 확인하세요:

```bash theme={null}
youka deps ensure --for render
```

그런 다음 `--local`로 내보내세요:

```bash theme={null}
youka export create $PROJECT_ID \
  --local \
  --resolution 1080p \
  --output ./karaoke.mp4 \
  --json
```

<Note>
  로컬 렌더는 `--output` 경로에 직접 기록합니다. `--local`과 함께 `--download`를 전달하지 마세요. 로컬 렌더 후에는 다운로드할 클라우드 아티팩트가 없기 때문에 CLI가 그 조합을 거부합니다.
</Note>

## `export quote`

내보내기를 시작하지 않고 클라우드 내보내기에 필요한 크레딧을 견적합니다.

```bash theme={null}
youka export quote <projectId> [options]
```

`export quote`는 클라우드 내보내기만 견적합니다. 로컬 내보내기는 사용자의 머신에서 실행되며
클라우드 내보내기 크레딧을 사용하지 않습니다.

| Option                  | Description                      |
| ----------------------- | -------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, 또는 `4k` |
| `--quality <value>`     | `low`, `medium`, 또는 `high`       |
| `--speed <number>`      | 재생 속도 배수                         |
| `--tone <number>`       | 피치 시프트 배수                        |
| `--transparent`         | 투명한 배경으로 렌더링                     |
| `--preset <presetId>`   | 이 내보내기에 대한 프리셋 재정의               |
| `--volume <stem=value>` | 타입별 스템 볼륨 설정. 반복 가능              |

예시:

```bash theme={null}
youka export quote $PROJECT_ID \
  --resolution 1080p \
  --quality high \
  --json
```

## `export list`

프로젝트의 내보내기 목록을 표시합니다.

```bash theme={null}
youka export list <projectId> [--page <n>] [--page-size <n>]
```

| Option        | Default | Description       |
| ------------- | ------- | ----------------- |
| `--page`      | `1`     | 페이지 번호.           |
| `--page-size` | `100`   | 페이지 크기. 최대 `100`. |

예시:

```bash theme={null}
youka export list $PROJECT_ID --page-size 50 --json
```

## `export show`

ID로 내보내기 하나를 가져옵니다.

```bash theme={null}
youka export show <exportId>
youka export show <exportId> --json
```

## `export wait`

내보내기가 종료 상태에 도달할 때까지 폴링합니다.

```bash theme={null}
youka export wait <exportId> --json
```

## `export download`

ID로 기존 내보내기를 다운로드합니다.

```bash theme={null}
youka export download <exportId> [--output <file>]
```

예시:

```bash theme={null}
youka export download $EXPORT_ID \
  --output ./karaoke.mp4
```

## 다음 단계

* [Projects](/ko/cli/projects) - 내보내기 전에 프로젝트를 생성하거나 프로젝트가 준비될 때까지 기다리기
* [Presets](/ko/cli/presets) - 내보내기 간 렌더 설정 재사용하기
* [Dependencies](/ko/cli/deps) - 로컬 렌더 의존성 확인 및 설치하기