Proyectos

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.

youka project create <source> [options]

string

required

Una ruta de archivo local (./song.mp3) o una URL HTTP/HTTPS (https://example.com/song.mp4).

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

youka project create ./song.mp3 \
  --title "My Song" \
  --mode transcribe \
  --lang en \
  --wait \
  --json

youka project create "https://example.com/song.mp4" \
  --max-video-quality 4k \
  --download \
  --output ./karaoke.mp4 \
  --json

youka project create ./song.mp3 \
  --mode align \
  --lyrics "$(cat lyrics.txt)" \
  --sync-model audioshake-alignment \
  --wait \
  --json

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.

youka project list
youka project list --json

`project quote`

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

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:

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.

youka project show <projectId>

string

required

El ID del proyecto devuelto por project create.

`project wait`

Sondea un proyecto hasta que alcance un estado terminal.

youka project wait <projectId> --json

`project delete`

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

youka project delete <projectId> --idempotency-key delete-<projectId>

La eliminación es permanente. Pasa --idempotency-key para que los reintentos sean seguros.

`project sync`

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

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:

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.

youka project separate <projectId> [--split-model <model>]

Ejemplo:

youka project separate $PROJECT_ID --split-model audioshakeai --wait --json

`project settings`

Lee o actualiza la configuración activa del proyecto.

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:

youka project settings $PROJECT_ID --json

youka project settings $PROJECT_ID \
  --preset preset_abc123 \
  --body ./project-settings.json \
  --json

`project stem list`

Lista los stems de un proyecto.

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.

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 - renderiza el karaoke finalizado
Presets - administra configuraciones de renderizado reutilizables
Render settings reference - campos compartidos de presets y configuración

Overview

How To

Customization

Audio

Settings

Exporting

Account

`project create`

Opciones

Ejemplos

`project list`

`project quote`

Opciones

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

Qué sigue

​project create

​Opciones

​Ejemplos

​project list

​project quote

​Opciones

​project show

​project wait

​project delete

​project sync

​project separate

​project settings

​project stem list

​project stem download

​Qué sigue

`project create`

Opciones

Ejemplos

`project list`

`project quote`

Opciones

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

Qué sigue