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

# Exports

> Rendre et télécharger des exports de karaoké dans le cloud ou sur la machine locale

Un export est un artefact rendu produit à partir d’un projet. Les exports s’exécutent dans le cloud par défaut. Passez `--local` pour rendre sur votre propre machine avec le pipeline Remotion local.

## `export create`

Rendre un nouvel export pour un projet.

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

<ParamField path="projectId" type="string" required>
  Le projet à exporter.
</ParamField>

### Options

| Option                  | Description                                                           |
| ----------------------- | --------------------------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p` ou `4k`                                       |
| `--quality <value>`     | `low`, `medium` ou `high`                                             |
| `--speed <number>`      | Multiplicateur de vitesse de lecture                                  |
| `--tone <number>`       | Multiplicateur de transposition de hauteur (pitch)                    |
| `--transparent`         | Rendre avec un arrière-plan transparent                               |
| `--preset <presetId>`   | Remplacement de preset pour cet export                                |
| `--volume <stem=value>` | Définir le volume d’une piste (stem) par type. Répétable              |
| `--local`               | Rendre en local plutôt que dans le cloud                              |
| `--download`            | Attendre l’export et le télécharger                                   |
| `--output <path>`       | Fichier ou dossier de sortie pour un rendu local ou un téléchargement |

### Volumes des stems

Utilisez `--volume <type>=<value>`. Les types valides sont `original`, `vocals`, `instrumental` et `backing_vocals`. Les valeurs doivent être comprises entre `0` et `1`.

### Rendu dans le cloud

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

### Rendu local

Le rendu local exécute le pipeline Remotion sur votre machine. Assurez-vous d’abord que les dépendances de rendu sont installées :

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

Puis exportez avec `--local` :

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

<Note>
  Les rendus locaux écrivent directement vers le chemin `--output`. Ne passez pas `--download`
  avec `--local` ; la CLI refuse cette combinaison car il n’y a aucun artefact
  cloud à télécharger après un rendu local.
</Note>

## `export quote`

Estimer les crédits requis pour un export cloud sans démarrer l’export.

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

`export quote` n’estime que les exports cloud. Les exports locaux s’exécutent sur votre machine et
n’utilisent pas de crédits d’export cloud.

| Option                  | Description                                              |
| ----------------------- | -------------------------------------------------------- |
| `--resolution <value>`  | `480p`, `720p`, `1080p` ou `4k`                          |
| `--quality <value>`     | `low`, `medium` ou `high`                                |
| `--speed <number>`      | Multiplicateur de vitesse de lecture                     |
| `--tone <number>`       | Multiplicateur de transposition de hauteur (pitch)       |
| `--transparent`         | Rendre avec un arrière-plan transparent                  |
| `--preset <presetId>`   | Remplacement de preset pour cet export                   |
| `--volume <stem=value>` | Définir le volume d’une piste (stem) par type. Répétable |

Exemple :

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

## `export list`

Lister les exports d’un projet.

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

| Option        | Default | Description                    |
| ------------- | ------- | ------------------------------ |
| `--page`      | `1`     | Numéro de page.                |
| `--page-size` | `100`   | Taille de page. Maximum `100`. |

Exemple :

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

## `export show`

Récupérer un export par ID.

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

## `export wait`

Interroger un export jusqu’à ce qu’il atteigne un état terminal.

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

## `export download`

Télécharger un export existant par ID.

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

Exemple :

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

## Et ensuite

* [Projects](/fr/cli/projects) - créer ou attendre des projets avant d’exporter
* [Presets](/fr/cli/presets) - réutiliser les paramètres de rendu entre exports
* [Dependencies](/fr/cli/deps) - inspecter et installer les dépendances de rendu local