Skip to main content
Un proyecto contiene el medio de origen, la letra, los ajustes de renderizado y las exportaciones de un karaoke o lyric video. Los proyectos de karaoke también contienen stems separados.

​
project create

Crea un proyecto nuevo a partir de un archivo local o una URL.
​
string
required
Una ruta de archivo local (./song.mp3) o una URL HTTP/HTTPS (https://example.com/song.mp4).

​
Options

​
Examples

Reglas:
  • Si proporcionas letras y omites --mode, la CLI usa por defecto align
  • align requiere letras
  • transcribe acepta letras de referencia opcionales. El modelo puede devolver un texto diferente.
  • none no acepta letras
  • --kind lyric-video usa el audio original sin separación de stems y rechaza --split-model. Omitir --kind conserva el comportamiento de karaoke.
  • --download implica --export
  • --max-video-quality solo se aplica a fuentes URL HTTP/HTTPS. El valor predeterminado 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.

​
project quote

Cotiza los créditos necesarios para crear un proyecto sin crear el proyecto.
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 medio con precisión, pero no crea un proyecto.

​
Options

Ejemplos:

​
project show

Obtén el estado actual del proyecto, incluyendo state, pendingOperation, stems, ajustes y exportaciones normalizados.
​
string
required
El ID del proyecto devuelto por project create.

​
project wait

Sondea un proyecto hasta que alcance un estado terminal.

​
project delete

Elimina un proyecto y todos sus stems, letras y exportaciones asociados.
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.
Ejemplo:

​
project separate

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

​
project settings

Lee o actualiza los ajustes activos del proyecto.
Si no está presente ni --preset ni --body, el comando devuelve los ajustes actuales. Si está presente cualquiera de los dos, realiza una actualización. Ejemplos:

​
project stem list

Lista los stems de un proyecto.

​
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.
Los valores admitidos para --type son original, instrumental, vocals y backing_vocals. La CLI también acepta backing-vocals, backingVocals y backingvocals como alias.

​
What’s next

​
Capabilities, versions, and timings

youka capabilities --json devuelve IDs de modelos, flujos de trabajo compatibles, manejo de texto, soporte de idiomas y elegibilidad de la cuenta. Wav2Vec2 es un modelo de alineación. ElevenLabs Scribe es un modelo de transcripción. Los modelos que requieren voces aisladas necesitan un flujo de trabajo de karaoke con un modelo de separación que produzca voces.
project settings --version-id lee o actualiza la versión elegida. Omitir el flag usa la versión principal. Las importaciones de timings reemplazan la alineación completa sin un trabajo de procesamiento ni retención de créditos. El cuerpo JSON contiene alignment y expectedRevision. El guardado y selección atómicos también necesitan select: true y expectedSelectionRevision. Un token desactualizado devuelve HTTP 409. Obtén y compara los valores actuales antes de intentar otra edición. Consulta Automate lyric videos para archivos de solicitud, validación de timings y procesamiento reanudable del catálogo.