Un progetto è la risorsa “in lavorazione” per una singola traccia karaoke. Contiene i media sorgente, i testi sincronizzati, gli stem separati, le impostazioni di rendering e gli export creati a partire da esso.
project create
Crea un nuovo progetto a partire da un file locale o da un URL.
youka project create <source> [options]
Un percorso di file locale (./song.mp3) o un URL HTTP/HTTPS
(https://example.com/song.mp4).
Options
| Option | Description |
|---|
--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 degli stem |
--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 dopo che 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
- Se passi i lyrics e ometti
--mode, la CLI usa per impostazione predefinita align
align richiede i lyricstranscribe e none non accettano i lyrics--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
Calcola il preventivo dei 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 con precisione la durata dei media, ma non crea un progetto.
Options
| Option | Description |
|---|
--title <title> | Titolo del progetto |
--mode <mode> | none, transcribe o align |
--lyrics <text> | Testo dei lyrics per align |
--lang <code> | Codice lingua |
--sync-model <model> | Modello di sincronizzazione dei lyrics |
--split-model <model> | Modello di separazione degli stem |
--max-video-quality <quality> | Qualità video massima per sorgenti URL: 720p, 1080p, 4k o best |
--duration <seconds> | Preventivo a partire da una durata nota senza caricare la sorgente |
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 corrente del progetto, inclusi state normalizzato, pendingOperation, stem, impostazioni ed export.
youka project show <projectId>
L’ID del progetto restituito da project create.
project wait
Esegue il polling di un progetto finché non raggiunge uno stato terminale.
youka project wait <projectId> --json
project delete
Elimina un progetto e tutti gli stem, 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 |
youka project sync $PROJECT_ID \
--mode align \
--text "$(cat lyrics.txt)" \
--wait \
--json
project separate
Esegue di nuovo la separazione degli stem su un progetto esistente.
youka project separate <projectId> [--split-model <model>]
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
--preset né --body, il comando restituisce le impostazioni correnti. Se è presente uno dei due, esegue un aggiornamento.
Examples:
youka project settings $PROJECT_ID --json
project stem list
Elenca gli stem 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. Gli stem vengono scaricati nel loro formato originale
memorizzato; la CLI non li 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
--type sono original, instrumental, vocals e
backing_vocals. La CLI accetta anche backing-vocals, backingVocals e
backingvocals come alias.
What’s next
