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

# Exportações

> Renderize e baixe exportações de karaokê na nuvem ou na máquina local

Uma exportação é um artefato renderizado gerado a partir de um projeto. As exportações são executadas na nuvem por padrão. Passe `--local` para renderizar na sua própria máquina com o pipeline local do Remotion.

## `export create`

Renderize uma nova exportação para um projeto.

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

<ParamField path="projectId" type="string" required>
  O projeto a exportar.
</ParamField>

### Options

| Option                  | Description                                                 |
| ----------------------- | ----------------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p` ou `4k`                             |
| `--quality <value>`     | `low`, `medium`, ou `high`                                  |
| `--speed <number>`      | Multiplicador de velocidade de reprodução                   |
| `--tone <number>`       | Multiplicador de mudança de tom (pitch)                     |
| `--transparent`         | Renderizar com fundo transparente                           |
| `--preset <presetId>`   | Substituição de preset para esta exportação                 |
| `--volume <stem=value>` | Definir volume do stem por tipo. Repetível                  |
| `--local`               | Renderizar localmente em vez de na nuvem                    |
| `--download`            | Aguardar a exportação e baixá-la                            |
| `--output <path>`       | Arquivo ou diretório de saída para render local ou download |

### Volumes de stem

Use `--volume <type>=<value>`. Os tipos válidos são `original`, `vocals`, `instrumental` e `backing_vocals`. Os valores devem estar entre `0` e `1`.

### Renderização na nuvem

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

### Renderização local

A renderização local executa o pipeline do Remotion na sua máquina. Primeiro, garanta que as dependências de renderização estejam instaladas:

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

Em seguida, exporte com `--local`:

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

<Note>
  Renderizações locais gravam diretamente no caminho `--output`. Não passe `--download`
  com `--local`; a CLI rejeita essa combinação porque não há nenhum artefato na nuvem
  para baixar após uma renderização local.
</Note>

## `export quote`

Estime os créditos necessários para uma exportação na nuvem sem iniciar a exportação.

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

`export quote` apenas estima exportações na nuvem. Exportações locais são executadas na sua máquina e
não usam créditos de exportação na nuvem.

| Option                  | Description                                 |
| ----------------------- | ------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p` ou `4k`             |
| `--quality <value>`     | `low`, `medium`, ou `high`                  |
| `--speed <number>`      | Multiplicador de velocidade de reprodução   |
| `--tone <number>`       | Multiplicador de mudança de tom (pitch)     |
| `--transparent`         | Renderizar com fundo transparente           |
| `--preset <presetId>`   | Substituição de preset para esta exportação |
| `--volume <stem=value>` | Definir volume do stem por tipo. Repetível  |

Exemplo:

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

## `export list`

Liste exportações de um projeto.

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

| Option        | Default | Description                      |
| ------------- | ------- | -------------------------------- |
| `--page`      | `1`     | Número da página.                |
| `--page-size` | `100`   | Tamanho da página. Máximo `100`. |

Exemplo:

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

## `export show`

Busque uma exportação pelo ID.

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

## `export wait`

Consulte uma exportação até que ela atinja um estado terminal.

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

## `export download`

Baixe uma exportação existente pelo ID.

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

Exemplo:

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

## O que vem a seguir

* [Projects](/pt/cli/projects) - crie ou aguarde projetos antes de exportar
* [Presets](/pt/cli/presets) - reutilize configurações de renderização entre exportações
* [Dependencies](/pt/cli/deps) - inspecione e instale dependências locais de renderização