Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.youka.io/llms.txt

Use this file to discover all available pages before exploring further.

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]
​
source
string
required
Un percorso di file locale (./song.mp3) o un URL HTTP/HTTPS (https://example.com/song.mp4).

​
Options

OptionDescription
--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
--exportCrea un export dopo che il progetto è pronto
--downloadCrea 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
Regole:
  • Se passi i lyrics e ometti --mode, la CLI usa per impostazione predefinita align
  • align richiede i lyrics
  • transcribe 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

OptionDescription
--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
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 corrente del progetto, inclusi state normalizzato, pendingOperation, stem, impostazioni ed export. 
youka project show <projectId>
​
projectId
string
required
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]
OptionDescription
--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 degli stem 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

​
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
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