> ## 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 > Erstellen, prüfen, darauf warten und Work-in-Progress-Karaokeprojekte verändern Ein Projekt ist die Work-in-Progress-Ressource für einen Karaoke-Track. Es enthält die Quellmedien, synchronisierte Lyrics, getrennte Stems, Render-Einstellungen und die daraus erstellten Exporte. ## `project create` Erstelle ein neues Projekt aus einer lokalen Datei oder einer URL. ```bash theme={null} youka project create [options] ``` Ein lokaler Dateipfad (`./song.mp3`) oder eine HTTP/HTTPS-URL (`https://example.com/song.mp4`). ### Options | Option | Description | | ------------------------------- | ------------------------------------------------------------------------- | | `--title ` | Projekttitel | | `--mode <mode>` | `none`, `transcribe` oder `align` | | `--lyrics <text>` | Lyrics-Text | | `--lang <code>` | Sprachcode | | `--sync-model <model>` | Lyrics-Sync-Modell | | `--split-model <model>` | Stem-Separationsmodell | | `--max-video-quality <quality>` | Maximale Videoqualität für URL-Quellen: `720p`, `1080p`, `4k` oder `best` | | `--preset <presetId>` | Beim Erstellen des Projekts ein Preset anwenden | | `--export` | Einen Export erstellen, nachdem das Projekt bereit ist | | `--download` | Einen Export erstellen, darauf warten und ihn herunterladen | | `--output <path>` | Ausgabepfad für `--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> Regeln: * Wenn du Lyrics übergibst und `--mode` weglässt, verwendet die CLI standardmäßig `align` * `align` erfordert Lyrics * `transcribe` und `none` akzeptieren keine Lyrics * `--download` impliziert `--export` * `--max-video-quality` gilt nur für HTTP/HTTPS-URL-Quellen. Standard ist `1080p`; es wird die beste verfügbare Qualität bis zu diesem Limit verwendet und auf das beste verfügbare Format zurückgefallen, wenn die Plattform keinen begrenzten Stream anbietet. ## `project list` Alle Projekte für das authentifizierte Konto auflisten. ```bash theme={null} youka project list youka project list --json ``` ## `project quote` Die Credits angeben, die zum Erstellen eines Projekts erforderlich sind, ohne das Projekt zu erstellen. ```bash theme={null} youka project quote <source> [options] ``` `source` akzeptiert dieselben lokalen Dateipfade oder HTTP/HTTPS-URL-Formen wie `project create`. Ohne `--duration` lädt die CLI die Quelle hoch, damit der Server die Medien exakt messen kann, erstellt jedoch kein Projekt. ### Options | Option | Description | | ------------------------------- | ------------------------------------------------------------------------- | | `--title <title>` | Projekttitel | | `--mode <mode>` | `none`, `transcribe` oder `align` | | `--lyrics <text>` | Lyrics-Text für `align` | | `--lang <code>` | Sprachcode | | `--sync-model <model>` | Lyrics-Sync-Modell | | `--split-model <model>` | Stem-Separationsmodell | | `--max-video-quality <quality>` | Maximale Videoqualität für URL-Quellen: `720p`, `1080p`, `4k` oder `best` | | `--duration <seconds>` | Auf Basis einer bekannten Dauer quoten, ohne die Quelle hochzuladen | Beispiele: ```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` Den aktuellen Projektstatus abrufen, einschließlich normalisiertem `state`, `pendingOperation`, Stems, Einstellungen und Exporten. ```bash theme={null} youka project show <projectId> ``` <ParamField path="projectId" type="string" required> Die von `project create` zurückgegebene Projekt-ID. </ParamField> ## `project wait` Ein Projekt abfragen, bis es einen Endzustand erreicht. ```bash theme={null} youka project wait <projectId> --json ``` ## `project delete` Ein Projekt und alle zugehörigen Stems, Lyrics und Exporte löschen. ```bash theme={null} youka project delete <projectId> --idempotency-key delete-<projectId> ``` <Warning> Das Löschen ist endgültig. Übergib `--idempotency-key`, um Wiederholungen sicher zu machen. </Warning> ## `project sync` Lyrics-Transkription oder Alignment für ein bestehendes Projekt erneut ausführen. ```bash theme={null} youka project sync <projectId> [options] ``` | Option | Description | | ---------------------- | ------------------------- | | `--mode <mode>` | `transcribe` oder `align` | | `--text <text>` | Lyrics-Text | | `--lang <code>` | Sprachcode | | `--sync-model <model>` | Lyrics-Sync-Modell | Beispiel: ```bash theme={null} youka project sync $PROJECT_ID \ --mode align \ --text "$(cat lyrics.txt)" \ --wait \ --json ``` ## `project separate` Stem-Separation für ein bestehendes Projekt erneut ausführen. ```bash theme={null} youka project separate <projectId> [--split-model <model>] ``` Beispiel: ```bash theme={null} youka project separate $PROJECT_ID --split-model audioshakeai --wait --json ``` ## `project settings` Die aktiven Projekt-Einstellungen lesen oder aktualisieren. ```bash theme={null} youka project settings <projectId> youka project settings <projectId> --preset <presetId> --body ./settings.json ``` Wenn weder `--preset` noch `--body` vorhanden ist, gibt der Befehl die aktuellen Einstellungen zurück. Wenn eines von beiden vorhanden ist, führt er ein Update aus. Beispiele: <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` Stems für ein Projekt auflisten. ```bash theme={null} youka project stem list <projectId> youka project stem list <projectId> --json ``` ## `project stem download` Eine oder mehrere Stem-Dateien auf die Festplatte herunterladen. Stems werden in ihrem original gespeicherten Format heruntergeladen; die CLI transkodiert sie nicht. ```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 ``` Unterstützte `--type`-Werte sind `original`, `instrumental`, `vocals` und `backing_vocals`. Die CLI akzeptiert außerdem `backing-vocals`, `backingVocals` und `backingvocals` als Aliase. ## What's next * [Exports](/de/cli/exports) - das fertige Karaoke rendern * [Presets](/de/cli/presets) - wiederverwendbare Render-Konfigurationen verwalten * [Render settings reference](/en/render-settings-reference) - gemeinsame Preset- und Einstellungsfelder