> ## 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. # Projects > Crea, ispeziona, attendi e modifica progetti karaoke in lavorazione 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. ```bash theme={null} youka project create [options] ``` Un percorso di file locale (`./song.mp3`) o un URL HTTP/HTTPS (`https://example.com/song.mp4`). ### Options | Option | Description | | ------------------------------- | ---------------------------------------------------------------------- | | `--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 <CodeGroup> ```bash local-file theme={null} youka project create ./song.mp3 \ --title "My Song" \ --mode transcribe \ --lang en \ --wait \ --json ``` ```bash url theme={null} youka project create "https://example.com/song.mp4" \ --max-video-quality 4k \ --download \ --output ./karaoke.mp4 \ --json ``` ```bash align theme={null} youka project create ./song.mp3 \ --mode align \ --lyrics "$(cat lyrics.txt)" \ --sync-model audioshake-alignment \ --wait \ --json ``` </CodeGroup> 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. ```bash theme={null} youka project list youka project list --json ``` ## `project quote` Calcola il preventivo dei crediti necessari per creare un progetto senza creare il progetto. ```bash theme={null} 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 | Examples: ```bash theme={null} 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. ```bash theme={null} youka project show <projectId> ``` <ParamField path="projectId" type="string" required> L’ID del progetto restituito da `project create`. </ParamField> ## `project wait` Esegue il polling di un progetto finché non raggiunge uno stato terminale. ```bash theme={null} youka project wait <projectId> --json ``` ## `project delete` Elimina un progetto e tutti gli stem, i lyrics e gli export associati. ```bash theme={null} youka project delete <projectId> --idempotency-key delete-<projectId> ``` <Warning> L’eliminazione è permanente. Passa `--idempotency-key` per rendere sicuri i tentativi ripetuti. </Warning> ## `project sync` Esegue di nuovo la trascrizione o l’allineamento dei lyrics su un progetto esistente. ```bash theme={null} 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: ```bash theme={null} 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. ```bash theme={null} youka project separate <projectId> [--split-model <model>] ``` Example: ```bash theme={null} youka project separate $PROJECT_ID --split-model audioshakeai --wait --json ``` ## `project settings` Leggi o aggiorna le impostazioni attive del progetto. ```bash theme={null} 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: <CodeGroup> ```bash show theme={null} youka project settings $PROJECT_ID --json ``` ```bash update theme={null} youka project settings $PROJECT_ID \ --preset preset_abc123 \ --body ./project-settings.json \ --json ``` </CodeGroup> ## `project stem list` Elenca gli stem di un progetto. ```bash theme={null} 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. ```bash theme={null} 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](/it/cli/exports) - esegui il rendering del karaoke finito * [Presets](/it/cli/presets) - gestisci configurazioni di rendering riutilizzabili * [Render settings reference](/en/render-settings-reference) - campi condivisi di preset e impostazioni