Skip to main content
Eine Voreinstellung ist eine wiederverwendbare Render-Konfiguration — Hintergrund, Untertitelstil, Layout und andere visuelle Einstellungen —, die du auf jedes Projekt oder jeden Export anwenden kannst. Voreinstellungen sind ideal, wenn du über viele Tracks hinweg ein konsistentes Erscheinungsbild hast. Siehe Render settings reference für die vollständige preset-Struktur und jede Enum-basierte Option.

preset schema

Gib das JSON Schema für die Voreinstellungs-Einstellungen zurück. Nutze dies, um gültige Felder zu ermitteln, bevor du eine Voreinstellung erstellst oder aktualisierst.
youka preset schema --json
Agents sollten preset schema aufrufen, bevor sie Voreinstellungen verändern, damit sie die exakten Feldnamen und Werttypen kennen.

preset list

Liste alle Voreinstellungen auf, die dem authentifizierten Konto gehören.
youka preset list --json

preset show

Rufe eine einzelne Voreinstellung anhand der ID ab.
youka preset show <presetId> --json

preset create

Erstelle eine neue Voreinstellung.
youka preset create [options]

Optionen

OptionBeschreibung
--name <name>Name der Voreinstellung
--defaultDie neue Voreinstellung als Standard markieren
--body <file|->Den vollständigen Request-Body aus einer Datei oder stdin lesen
Der Request-Body sollte das vollständige preset-Objekt enthalten. Bei großen Payloads bevorzuge --body statt inline JSON.

Beispiele

youka preset create \
  --name "Neon Night" \
  --body ./neon-preset.json \
  --json
CLI-Flags überschreiben entsprechende Felder aus --body.

preset update

Aktualisiere eine bestehende Voreinstellung.
youka preset update <presetId> [options]
OptionBeschreibung
--name <name>Neuer Name
--body <file|->Vollständiger Request-Body aus Datei oder stdin
Beispiel:
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json

preset delete

Lösche eine Voreinstellung anhand der ID.
youka preset delete <presetId> --json
Das Löschen einer Voreinstellung löscht keine Projekte oder Exporte, die zuvor damit gerendert wurden. Zukünftige Exporte, die auf die gelöschte Voreinstellung verweisen, schlagen fehl.

preset default

Rufe die Standard-Voreinstellung ab oder setze sie.
youka preset default --json
youka preset default <presetId> --json
Ohne Argument gibt der Befehl die aktuelle Standard-Voreinstellung oder null zurück. Mit einer Voreinstellungs-ID wird diese Voreinstellung als Standard markiert.

Anwenden einer Voreinstellung

Wende eine Voreinstellung mit --preset auf ein Projekt oder einen Export an:
youka project create ./song.mp3 --preset $PRESET_ID --wait

Wie geht es weiter

  • Render settings reference - alle gemeinsamen Voreinstellungs-Felder
  • Projects - Voreinstellungen auf Projekteinstellungen anwenden
  • Exports - Voreinstellungen zur Render-Zeit anwenden
  • Media - wiederverwendbare Medien, auf die Voreinstellungen verweisen