Skip to main content
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]
​
source
string
required
Una ruta de archivo local (./song.mp3) o una URL HTTP/HTTPS (https://example.com/song.mp4).

​
Opciones

OpciónDescripció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
--exportCrea una exportación cuando el proyecto esté listo
--downloadCrea 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
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ónDescripció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>
​
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ónDescripció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

​
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