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

# 导出

> 在云端或本地机器上渲染并下载卡拉 OK 导出文件

导出（export）是从项目生成的渲染产物。默认情况下，导出在云端运行。传入 `--local` 可使用本地 Remotion 流水线在你的机器上渲染。

## `export create`

为项目渲染一个新的导出。

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

<ParamField path="projectId" type="string" required>
  要导出的项目。
</ParamField>

### 选项

| 选项                      | 描述                           |
| ----------------------- | ---------------------------- |
| `--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>`       | 本地渲染或下载时的输出文件或目录             |

### 分轨音量

使用 `--volume <type>=<value>`。有效类型为 `original`、`vocals`、`instrumental` 和 `backing_vocals`。取值必须在 `0` 到 `1` 之间。

### 云端渲染

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

### 本地渲染

本地渲染会在你的机器上运行 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`

在不启动导出的情况下，估算一次云端导出所需的点数（credits）。

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

`export quote` 只会估算云端导出。本地导出在你的机器上运行，不会消耗云端导出点数。

| 选项                      | 描述                           |
| ----------------------- | ---------------------------- |
| `--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>]
```

| 选项            | 默认值   | 描述              |
| ------------- | ----- | --------------- |
| `--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](/zh/cli/projects) - 在导出前创建项目或等待项目完成
* [Presets](/zh/cli/presets) - 在多个导出之间复用渲染设置
* [Dependencies](/zh/cli/deps) - 检查并安装本地渲染依赖