Projekte

Ein Projekt enthält die Quellmedien, Lyrics, Render-Einstellungen und Exporte für ein Karaoke- oder Lyric-Video. Karaoke-Projekte enthalten außerdem separierte Stems.

`project create`

Erstelle ein neues Projekt aus einer lokalen Datei oder einer URL.

youka project create <source> [options]

string

required

Ein lokaler Dateipfad (./song.mp3) oder eine HTTP/HTTPS-URL (https://example.com/song.mp4).

Options

Option	Description
`--kind <kind>`	`karaoke` oder `lyric-video`. Standard ist `karaoke`.
`--title <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-Trennungsmodell
`--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

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

Regeln:

Wenn du Lyrics übergibst und --mode weglässt, verwendet die CLI standardmäßig align
align erfordert Lyrics
transcribe akzeptiert optional Referenz-Lyrics. Das Modell kann anderen Text zurückgeben.
none akzeptiert keine Lyrics
--kind lyric-video verwendet das Originalaudio ohne Stem-Trennung und lehnt --split-model ab. Wenn --kind weggelassen wird, bleibt das Karaoke-Verhalten erhalten.
--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 dieser Grenze verwendet, und es wird auf das beste verfügbare Format zurückgefallen, wenn die Plattform keinen begrenzten Stream anbietet.

`project list`

Liste alle Projekte für das authentifizierte Konto auf.

youka project list
youka project list --json

`project quote`

Ermittle die Credits, die zum Erstellen eines Projekts erforderlich sind, ohne das Projekt zu erstellen.

youka project quote <source> [options]

source akzeptiert dieselben lokalen Dateipfad- 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 aber kein Projekt.

Options

Option	Description
`--kind <kind>`	`karaoke` oder `lyric-video`. Standard ist `karaoke`.
`--title <title>`	Projekttitel
`--mode <mode>`	`none`, `transcribe` oder `align`
`--lyrics <text>`	Erforderlicher Text für `align`, optionale Orientierung für `transcribe`
`--lang <code>`	Sprachcode
`--sync-model <model>`	Lyrics-Sync-Modell
`--split-model <model>`	Stem-Trennungsmodell
`--max-video-quality <quality>`	Maximale Videoqualität für URL-Quellen: `720p`, `1080p`, `4k` oder `best`
`--duration <seconds>`	Angebot auf Basis einer bekannten Dauer, ohne die Quelle hochzuladen

Beispiele:

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`

Rufe den aktuellen Projektstatus ab, einschließlich normalisiertem state, pendingOperation, Stems, Einstellungen und Exporten.

youka project show <projectId>

string

required

Die von project create zurückgegebene Projekt-ID.

`project wait`

Frage ein Projekt wiederholt ab, bis es einen Endzustand erreicht.

youka project wait <projectId> --json

`project delete`

Lösche ein Projekt und alle zugehörigen Stems, Lyrics und Exporte.

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

Das Löschen ist dauerhaft. Verwende --idempotency-key, um Wiederholungen sicher zu machen.

`project sync`

Führe die Lyrics-Transkription oder -Ausrichtung für ein bestehendes Projekt erneut aus.

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:

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

`project separate`

Führe die Stem-Trennung für ein bestehendes Projekt erneut aus.

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

Beispiel:

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

`project settings`

Lies oder aktualisiere die aktiven Projekteinstellungen.

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 durch. Beispiele:

youka project settings $PROJECT_ID --json

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

`project stem list`

Liste Stems für ein Projekt auf.

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

`project stem download`

Lade eine oder mehrere Stem-Dateien auf die Festplatte herunter. Stems werden in ihrem ursprünglich gespeicherten Format heruntergeladen; die CLI transkodiert sie nicht.

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 - rendere das fertige Karaoke
Presets - verwalte wiederverwendbare Render-Konfigurationen
Render settings reference - gemeinsam genutzte Preset- und Einstellungsfelder

Capabilities, versions, and timings

youka capabilities --json gibt Modell-IDs, unterstützte Workflows, Textverarbeitung, Sprachunterstützung und Konto-Berechtigung zurück. Wav2Vec2 ist ein Alignment-Modell. ElevenLabs Scribe ist ein Transkriptionsmodell. Modelle, die isolierte Vocals benötigen, erfordern einen Karaoke-Workflow mit einem Separation-Modell, das Vocals erzeugt.

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 liest oder aktualisiert die ausgewählte Version. Wenn das Flag weggelassen wird, wird die primäre Version verwendet. Timing-Imports ersetzen das vollständige Alignment ohne Processing-Job oder Credit-Hold. Der JSON-Body enthält alignment und expectedRevision. Für ein atomares Save-and-Select werden außerdem select: true und expectedSelectionRevision benötigt. Ein veraltetes Token gibt HTTP 409 zurück. Hole die aktuellen Werte ab und vergleiche sie, bevor du einen weiteren Edit versuchst. Siehe Automate lyric videos für Request-Dateien, Timing-Validierung und fortsetzbare Katalogverarbeitung.

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