Progetti

Un progetto contiene i media sorgente, i testi, le impostazioni di rendering e le esportazioni per un karaoke o un lyric video. I progetti karaoke contengono anche le stem separate.

`project create`

Crea un nuovo progetto da un file locale o da un URL.

youka project create <source> [options]

string

required

Un percorso file locale (./song.mp3) o un URL HTTP/HTTPS (https://example.com/song.mp4).

Options

Option	Description
`--kind <kind>`	`karaoke` o `lyric-video`. Predefinito: `karaoke`.
`--title <title>`	Titolo del progetto
`--mode <mode>`	`none`, `transcribe` o `align`
`--lyrics <text>`	Testo dei lyrics
`--lang <code>`	Codice lingua
`--sync-model <model>`	Modello di sincronizzazione dei lyrics
`--split-model <model>`	Modello di separazione delle stems
`--max-video-quality <quality>`	Qualità video massima per sorgenti URL: `720p`, `1080p`, `4k` o `best`
`--preset <presetId>`	Applica un preset durante la creazione del progetto
`--export`	Crea un export quando il progetto è pronto
`--download`	Crea un export, attendilo e scaricalo
`--output <path>`	Percorso di output per `--download`

Examples

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

Regole:

Se passi i lyrics e ometti --mode, la CLI usa align come predefinito
align richiede i lyrics
transcribe accetta lyrics di riferimento opzionali. Il modello potrebbe restituire un testo diverso.
none non accetta lyrics
--kind lyric-video usa l’audio originale senza separazione delle stems e rifiuta --split-model. Omettere --kind mantiene il comportamento karaoke.
--download implica --export
--max-video-quality si applica solo a sorgenti URL HTTP/HTTPS. Il valore predefinito è 1080p, usa la migliore qualità disponibile fino a quel limite e ripiega sul miglior formato disponibile quando la piattaforma non espone uno stream con limite.

`project list`

Elenca tutti i progetti per l’account autenticato.

youka project list
youka project list --json

`project quote`

Stima i crediti necessari per creare un progetto senza creare il progetto.

youka project quote <source> [options]

source accetta le stesse forme di percorso file locale o URL HTTP/HTTPS di project create. Senza --duration, la CLI carica la sorgente così che il server possa misurare esattamente il media, ma non crea un progetto.

Options

Option	Description
`--kind <kind>`	`karaoke` o `lyric-video`. Predefinito: `karaoke`.
`--title <title>`	Titolo del progetto
`--mode <mode>`	`none`, `transcribe` o `align`
`--lyrics <text>`	Testo richiesto per `align`, guida opzionale per `transcribe`
`--lang <code>`	Codice lingua
`--sync-model <model>`	Modello di sincronizzazione dei lyrics
`--split-model <model>`	Modello di separazione delle stems
`--max-video-quality <quality>`	Qualità video massima per sorgenti URL: `720p`, `1080p`, `4k` o `best`
`--duration <seconds>`	Stima basata su una durata nota senza caricare la sorgente

Examples:

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`

Ottieni lo stato attuale del progetto, inclusi state normalizzato, pendingOperation, stems, impostazioni ed export.

youka project show <projectId>

string

required

L’ID del progetto restituito da project create.

`project wait`

Esegue polling su un progetto finché non raggiunge uno stato terminale.

youka project wait <projectId> --json

`project delete`

Elimina un progetto e tutte le stems, i lyrics e gli export associati.

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

L’eliminazione è permanente. Passa --idempotency-key per rendere sicuri i tentativi ripetuti.

`project sync`

Esegue di nuovo la trascrizione o l’allineamento dei lyrics su un progetto esistente.

youka project sync <projectId> [options]

Option	Description
`--mode <mode>`	`transcribe` o `align`
`--text <text>`	Testo dei lyrics
`--lang <code>`	Codice lingua
`--sync-model <model>`	Modello di sincronizzazione dei lyrics

Example:

youka project sync $PROJECT_ID \
  --mode align \
  --text "$(cat lyrics.txt)" \
  --wait \
  --json

`project separate`

Esegue di nuovo la separazione delle stems su un progetto esistente.

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

Example:

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

`project settings`

Leggi o aggiorna le impostazioni attive del progetto.

youka project settings <projectId>
youka project settings <projectId> --preset <presetId> --body ./settings.json

Se non è presente né --preset né --body, il comando restituisce le impostazioni correnti. Se è presente uno dei due, esegue un aggiornamento. Examples:

youka project settings $PROJECT_ID --json

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

`project stem list`

Elenca le stems di un progetto.

youka project stem list <projectId>
youka project stem list <projectId> --json

`project stem download`

Scarica su disco uno o più file stem. Le stems vengono scaricate nel formato originale memorizzato; la CLI non le 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

I valori supportati per --type sono original, instrumental, vocals e backing_vocals. La CLI accetta anche backing-vocals, backingVocals e backingvocals come alias.

What’s next

Exports - esegui il rendering del karaoke finito
Presets - gestisci configurazioni di rendering riutilizzabili
Render settings reference - campi condivisi di preset e impostazioni

Capabilities, versions, and timings

youka capabilities --json restituisce ID dei modelli, workflow supportati, gestione del testo, supporto linguistico e idoneità dell’account. Wav2Vec2 è un modello di allineamento. ElevenLabs Scribe è un modello di trascrizione. I modelli che richiedono voci isolate necessitano di un workflow karaoke con un modello di separazione che produca le vocals.

youka capabilities --json
youka project create ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project quote ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project versions proj_example --json
youka project settings proj_example --version-id ver_example --json
youka project timings list proj_example --json
youka project timings get proj_example aln_example --json
youka project timings import proj_example aln_example --body corrected-request.json --json
youka project timings select proj_example aln_example --expected-revision "$ALIGNMENT_REVISION" --expected-selection-revision "$SELECTION_REVISION" --json

project settings --version-id legge o aggiorna la versione scelta. Omettere il flag usa la versione primaria. Gli import dei timing sostituiscono l’allineamento completo senza un job di elaborazione o un blocco crediti. Il body JSON contiene alignment e expectedRevision. Il salvataggio-e-selezione atomico richiede anche select: true e expectedSelectionRevision. Un token non aggiornato restituisce HTTP 409. Recupera e confronta i valori correnti prima di tentare un’altra modifica. Vedi Automate lyric videos per i file di richiesta, la validazione dei timing e l’elaborazione del catalogo riprendibile.

Overview

How To

Customization

Audio

Settings

Exporting

Account

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

What’s next

Capabilities, versions, and timings

​project create

​Options

​Examples

​project list

​project quote

​Options

​project show

​project wait

​project delete

​project sync

​project separate

​project settings

​project stem list

​project stem download

​What’s next

​Capabilities, versions, and timings

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

What’s next

Capabilities, versions, and timings