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

# Proyectos

> Crea, inspecciona, espera y modifica proyectos de karaoke en curso

Un proyecto es el recurso de trabajo en curso para una pista de karaoke. Contiene el contenido multimedia de origen, las letras sincronizadas, los stems separados, la configuración de renderizado y las exportaciones creadas a partir de él.

## `project create`

Crea un nuevo proyecto a partir de un archivo local o una URL.

```bash theme={null}
youka project create <source> [options]
```

<ParamField path="source" type="string" required>
  Una ruta de archivo local (`./song.mp3`) o una URL HTTP/HTTPS
  (`https://example.com/song.mp4`).
</ParamField>

### Opciones

| Opción                          | Descripción                                                                   |
| ------------------------------- | ----------------------------------------------------------------------------- |
| `--title <title>`               | Título del proyecto                                                           |
| `--mode <mode>`                 | `none`, `transcribe`, o `align`                                               |
| `--lyrics <text>`               | Texto de la letra                                                             |
| `--lang <code>`                 | Código de idioma                                                              |
| `--sync-model <model>`          | Modelo de sincronización de letras                                            |
| `--split-model <model>`         | Modelo de separación de stems                                                 |
| `--max-video-quality <quality>` | Calidad máxima de video para fuentes por URL: `720p`, `1080p`, `4k`, o `best` |
| `--preset <presetId>`           | Aplica un preset al crear el proyecto                                         |
| `--export`                      | Crea una exportación cuando el proyecto esté listo                            |
| `--download`                    | Crea una exportación, espera a que esté lista y la descarga                   |
| `--output <path>`               | Ruta de salida para `--download`                                              |

### Ejemplos

<CodeGroup>
  ```bash local-file theme={null}
  youka project create ./song.mp3 \
    --title "My Song" \
    --mode transcribe \
    --lang en \
    --wait \
    --json
  ```

  ```bash url theme={null}
  youka project create "https://example.com/song.mp4" \
    --max-video-quality 4k \
    --download \
    --output ./karaoke.mp4 \
    --json
  ```

  ```bash align theme={null}
  youka project create ./song.mp3 \
    --mode align \
    --lyrics "$(cat lyrics.txt)" \
    --sync-model audioshake-alignment \
    --wait \
    --json
  ```
</CodeGroup>

Reglas:

* Si pasas letras y omites `--mode`, la CLI usa `align` de forma predeterminada
* `align` requiere letras
* `transcribe` y `none` no aceptan letras
* `--download` implica `--export`
* `--max-video-quality` solo se aplica a fuentes por URL HTTP/HTTPS. De forma predeterminada es `1080p`, usa la mejor calidad disponible hasta ese límite y recurre al mejor formato disponible cuando la plataforma no expone un stream con límite.

## `project list`

Lista todos los proyectos de la cuenta autenticada.

```bash theme={null}
youka project list
youka project list --json
```

## `project quote`

Calcula los créditos necesarios para crear un proyecto sin crear el proyecto.

```bash theme={null}
youka project quote <source> [options]
```

`source` acepta las mismas formas de ruta de archivo local o URL HTTP/HTTPS que
`project create`. Sin `--duration`, la CLI sube el origen para que el servidor
pueda medir el contenido multimedia con precisión, pero no crea un proyecto.

### Opciones

| Opción                          | Descripción                                                                   |
| ------------------------------- | ----------------------------------------------------------------------------- |
| `--title <title>`               | Título del proyecto                                                           |
| `--mode <mode>`                 | `none`, `transcribe`, o `align`                                               |
| `--lyrics <text>`               | Texto de la letra para `align`                                                |
| `--lang <code>`                 | Código de idioma                                                              |
| `--sync-model <model>`          | Modelo de sincronización de letras                                            |
| `--split-model <model>`         | Modelo de separación de stems                                                 |
| `--max-video-quality <quality>` | Calidad máxima de video para fuentes por URL: `720p`, `1080p`, `4k`, o `best` |
| `--duration <seconds>`          | Cotiza a partir de una duración conocida sin subir el origen                  |

Ejemplos:

```bash theme={null}
youka project quote ./song.mp3 --mode transcribe --json
youka project quote https://example.com/song.mp4 --max-video-quality 4k --mode transcribe --json
youka project quote ./song.mp3 --duration 210 --mode none --json
```

## `project show`

Obtén el estado actual del proyecto, incluido `state` normalizado, `pendingOperation`, stems, configuración y exportaciones.

```bash theme={null}
youka project show <projectId>
```

<ParamField path="projectId" type="string" required>
  El ID del proyecto devuelto por `project create`.
</ParamField>

## `project wait`

Sondea un proyecto hasta que alcance un estado terminal.

```bash theme={null}
youka project wait <projectId> --json
```

## `project delete`

Elimina un proyecto y todos sus stems, letras y exportaciones asociados.

```bash theme={null}
youka project delete <projectId> --idempotency-key delete-<projectId>
```

<Warning>
  La eliminación es permanente. Pasa `--idempotency-key` para que los reintentos sean seguros.
</Warning>

## `project sync`

Vuelve a ejecutar la transcripción o la alineación de letras en un proyecto existente.

```bash theme={null}
youka project sync <projectId> [options]
```

| Opción                 | Descripción                        |
| ---------------------- | ---------------------------------- |
| `--mode <mode>`        | `transcribe` o `align`             |
| `--text <text>`        | Texto de la letra                  |
| `--lang <code>`        | Código de idioma                   |
| `--sync-model <model>` | Modelo de sincronización de letras |

Ejemplo:

```bash theme={null}
youka project sync $PROJECT_ID \
  --mode align \
  --text "$(cat lyrics.txt)" \
  --wait \
  --json
```

## `project separate`

Vuelve a ejecutar la separación de stems en un proyecto existente.

```bash theme={null}
youka project separate <projectId> [--split-model <model>]
```

Ejemplo:

```bash theme={null}
youka project separate $PROJECT_ID --split-model audioshakeai --wait --json
```

## `project settings`

Lee o actualiza la configuración activa del proyecto.

```bash theme={null}
youka project settings <projectId>
youka project settings <projectId> --preset <presetId> --body ./settings.json
```

Si no está presente ni `--preset` ni `--body`, el comando devuelve la configuración actual. Si está presente cualquiera de ellos, realiza una actualización.

Ejemplos:

<CodeGroup>
  ```bash show theme={null}
  youka project settings $PROJECT_ID --json
  ```

  ```bash update theme={null}
  youka project settings $PROJECT_ID \
    --preset preset_abc123 \
    --body ./project-settings.json \
    --json
  ```
</CodeGroup>

## `project stem list`

Lista los stems de un proyecto.

```bash theme={null}
youka project stem list <projectId>
youka project stem list <projectId> --json
```

## `project stem download`

Descarga uno o más archivos de stems al disco. Los stems se descargan en su formato
original almacenado; la CLI no los transcodifica.

```bash theme={null}
youka project stem download <projectId> <stemId> --output ./stems
youka project stem download <projectId> --type instrumental --output ./stems
youka project stem download <projectId> --type original --type backing-vocals --type vocals --output ./stems
youka project stem download <projectId> --all --output ./stems
```

Los valores admitidos para `--type` son `original`, `instrumental`, `vocals` y
`backing_vocals`. La CLI también acepta `backing-vocals`, `backingVocals` y
`backingvocals` como alias.

## Qué sigue

* [Exports](/es/cli/exports) - renderiza el karaoke finalizado
* [Presets](/es/cli/presets) - administra configuraciones de renderizado reutilizables
* [Render settings reference](/en/render-settings-reference) - campos compartidos de presets y configuración