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

# Esportazioni

> Esegui il render e scarica le esportazioni karaoke nel cloud o sulla macchina locale

Un’esportazione è un artefatto renderizzato prodotto da un progetto. Le esportazioni vengono eseguite nel cloud per impostazione predefinita. Passa `--local` per eseguire il render sulla tua macchina con la pipeline Remotion locale.

## `export create`

Esegui il render di una nuova esportazione per un progetto.

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

<ParamField path="projectId" type="string" required>
  Il progetto da esportare.
</ParamField>

### Opzioni

| Option                  | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, or `4k`                        |
| `--quality <value>`     | `low`, `medium`, or `high`                              |
| `--speed <number>`      | Moltiplicatore della velocità di riproduzione           |
| `--tone <number>`       | Moltiplicatore dello spostamento di intonazione         |
| `--transparent`         | Esegui il render con sfondo trasparente                 |
| `--preset <presetId>`   | Override del preset per questa esportazione             |
| `--volume <stem=value>` | Imposta il volume dello stem per tipo. Ripetibile       |
| `--local`               | Esegui il render in locale invece che nel cloud         |
| `--download`            | Attendi l’esportazione e scaricala                      |
| `--output <path>`       | File o directory di output per render locale o download |

### Volumi degli stem

Usa `--volume <type>=<value>`. I tipi validi sono `original`, `vocals`, `instrumental` e `backing_vocals`. I valori devono essere compresi tra `0` e `1`.

### Render nel cloud

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

### Render locale

Il rendering locale esegue la pipeline Remotion sulla tua macchina. Per prima cosa, assicurati che le dipendenze di rendering siano installate:

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

Poi esporta con `--local`:

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

<Note>
  I render locali scrivono direttamente nel percorso `--output`. Non passare `--download`
  con `--local`; la CLI rifiuta quella combinazione perché non esiste alcun artefatto nel cloud
  da scaricare dopo un render locale.
</Note>

## `export quote`

Stima i crediti necessari per un’esportazione nel cloud senza avviare l’esportazione.

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

`export quote` stima solo le esportazioni nel cloud. Le esportazioni locali vengono eseguite sulla tua macchina e
non usano crediti di esportazione nel cloud.

| Option                  | Description                                       |
| ----------------------- | ------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p`, or `4k`                  |
| `--quality <value>`     | `low`, `medium`, or `high`                        |
| `--speed <number>`      | Moltiplicatore della velocità di riproduzione     |
| `--tone <number>`       | Moltiplicatore dello spostamento di intonazione   |
| `--transparent`         | Esegui il render con sfondo trasparente           |
| `--preset <presetId>`   | Override del preset per questa esportazione       |
| `--volume <stem=value>` | Imposta il volume dello stem per tipo. Ripetibile |

Esempio:

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

## `export list`

Elenca le esportazioni per un progetto.

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

| Option        | Default | Description                       |
| ------------- | ------- | --------------------------------- |
| `--page`      | `1`     | Numero di pagina.                 |
| `--page-size` | `100`   | Dimensione pagina. Massimo `100`. |

Esempio:

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

## `export show`

Recupera un’esportazione tramite ID.

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

## `export wait`

Interroga un’esportazione finché non raggiunge uno stato terminale.

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

## `export download`

Scarica un’esportazione esistente tramite ID.

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

Esempio:

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

## Cosa c’è dopo

* [Projects](/it/cli/projects) - crea o attendi i progetti prima di esportare
* [Presets](/it/cli/presets) - riutilizza le impostazioni di rendering tra le esportazioni
* [Dependencies](/it/cli/deps) - ispeziona e installa le dipendenze di rendering locale