导出（export）是从项目生成的渲染产物。默认情况下，导出在云端运行。传入 --local 可使用本地 Remotion 流水线在你的机器上渲染。
export create
为项目渲染一个新的导出。
youka export create <projectId> [options]
| 选项 | 描述 |
|---|
--resolution <value> | 480p、720p 或 1080p |
--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 之间。
云端渲染
youka export create $PROJECT_ID \
--resolution 1080p \
--quality high \
--wait \
--download \
--output ./karaoke.mp4 \
--json
本地渲染
本地渲染会在你的机器上运行 Remotion 流水线。首先确保已安装渲染依赖：
youka deps ensure --for render
--local 导出：
youka export create $PROJECT_ID \
--local \
--resolution 1080p \
--output ./karaoke.mp4 \
--json
本地渲染会直接写入 --output 路径。不要在 --local 的同时传入 --download；CLI 会拒绝这种组合，因为本地渲染后没有可供下载的云端产物。
export quote
在不启动导出的情况下，估算一次云端导出所需的点数（credits）。
youka export quote <projectId> [options]
export quote 只会估算云端导出。本地导出在你的机器上运行，不会消耗云端导出点数。
| 选项 | 描述 |
|---|
--resolution <value> | 480p、720p 或 1080p |
--quality <value> | low、medium 或 high |
--speed <number> | 播放速度倍数 |
--tone <number> | 音高偏移倍数 |
--transparent | 使用透明背景渲染 |
--preset <presetId> | 为本次导出覆盖使用的预设 |
--volume <stem=value> | 按类型设置分轨音量。可重复指定 |
youka export quote $PROJECT_ID \
--resolution 1080p \
--quality high \
--json
export list
列出项目的导出。
youka export list <projectId> [--page <n>] [--page-size <n>]
| 选项 | 默认值 | 描述 |
|---|
--page | 1 | 页码。 |
--page-size | 100 | 每页数量。最大为 100。 |
youka export list $PROJECT_ID --page-size 50 --json
export show
按 ID 获取单个导出。
youka export show <exportId>
youka export show <exportId> --json
export wait
轮询导出直到其进入终止状态。
youka export wait <exportId> --json
export download
按 ID 下载已有导出。
youka export download <exportId> [--output <file>]
youka export download $EXPORT_ID \
--output ./karaoke.mp4
下一步
