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

# Exportaciones

> Renderiza y descarga exportaciones de karaoke en la nube o en la máquina local

Una exportación es un artefacto renderizado generado a partir de un proyecto. Las exportaciones se ejecutan en la nube de forma predeterminada. Pasa `--local` para renderizar en tu propia máquina con el pipeline local de Remotion.

## `export create`

Renderiza una nueva exportación para un proyecto.

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

<ParamField path="projectId" type="string" required>
  El proyecto a exportar.
</ParamField>

### Options

| Option                  | Description                                                 |
| ----------------------- | ----------------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p` o `4k`                              |
| `--quality <value>`     | `low`, `medium` o `high`                                    |
| `--speed <number>`      | Multiplicador de velocidad de reproducción                  |
| `--tone <number>`       | Multiplicador de cambio de tono                             |
| `--transparent`         | Renderizar con un fondo transparente                        |
| `--preset <presetId>`   | Anulación de preset para esta exportación                   |
| `--volume <stem=value>` | Establecer el volumen del stem por tipo. Repetible          |
| `--local`               | Renderizar localmente en lugar de en la nube                |
| `--download`            | Esperar a la exportación y descargarla                      |
| `--output <path>`       | Archivo o directorio de salida para render local o descarga |

### Volúmenes de stems

Usa `--volume <type>=<value>`. Los tipos válidos son `original`, `vocals`, `instrumental` y `backing_vocals`. Los valores deben estar entre `0` y `1`.

### Render en la nube

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

### Render local

El render local ejecuta el pipeline de Remotion en tu máquina. Primero, asegúrate de que las dependencias de render estén instaladas:

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

Luego exporta con `--local`:

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

<Note>
  Los renders locales escriben directamente en la ruta `--output`. No pases `--download`
  con `--local`; la CLI rechaza esa combinación porque no hay ningún artefacto en la nube
  para descargar después de un render local.
</Note>

## `export quote`

Calcula los créditos necesarios para una exportación en la nube sin iniciar la exportación.

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

`export quote` solo calcula exportaciones en la nube. Las exportaciones locales se ejecutan en tu máquina y
no usan créditos de exportación en la nube.

| Option                  | Description                                        |
| ----------------------- | -------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p` o `4k`                     |
| `--quality <value>`     | `low`, `medium` o `high`                           |
| `--speed <number>`      | Multiplicador de velocidad de reproducción         |
| `--tone <number>`       | Multiplicador de cambio de tono                    |
| `--transparent`         | Renderizar con un fondo transparente               |
| `--preset <presetId>`   | Anulación de preset para esta exportación          |
| `--volume <stem=value>` | Establecer el volumen del stem por tipo. Repetible |

Ejemplo:

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

## `export list`

Lista las exportaciones de un proyecto.

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

| Option        | Default | Description                     |
| ------------- | ------- | ------------------------------- |
| `--page`      | `1`     | Número de página.               |
| `--page-size` | `100`   | Tamaño de página. Máximo `100`. |

Ejemplo:

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

## `export show`

Obtén una exportación por ID.

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

## `export wait`

Consulta una exportación hasta que alcance un estado terminal.

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

## `export download`

Descarga una exportación existente por ID.

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

Ejemplo:

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

## Qué sigue

* [Projects](/es/cli/projects) - crea o espera proyectos antes de exportar
* [Presets](/es/cli/presets) - reutiliza ajustes de render entre exportaciones
* [Dependencies](/es/cli/deps) - inspecciona e instala dependencias locales de render