Presets

Ein Preset ist eine wiederverwendbare Render-Konfiguration — Hintergrund, Untertitel-Stil, Layout — die du auf jedes Projekt oder jeden Export anwenden kannst. Verwende Presets, wenn du über viele Tracks hinweg ein konsistentes Erscheinungsbild brauchst. Siehe Render settings reference für die vollständige preset-Struktur und jede enum-gestützte Option.

Wann du ein Preset verwenden solltest

Verwende ein Preset, wenn…

Du für viele Projekte dasselbe Erscheinungsbild möchtest und es an einer Stelle aktualisieren willst.

Verwende Projekteinstellungen, wenn…

Du projektlokale Overrides brauchst, die sich nicht zu teilen lohnen.

Endpunkte

Method	Path	Zweck
`GET`	`/presets`	Presets für den authentifizierten Account auflisten.
`POST`	`/presets`	Ein neues Preset erstellen.
`GET`	`/presets/{presetId}`	Ein einzelnes Preset abrufen.
`PATCH`	`/presets/{presetId}`	Name, Body aktualisieren oder als Standard festlegen.
`DELETE`	`/presets/{presetId}`	Ein Preset löschen.

Vollständige Request- und Response-Schemas findest du unter API reference in der Sidebar.

Ein Preset erstellen

curl -X POST https://api.youka.io/de/api/v1/presets \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: create-neon-night-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Neon Night",
    "preset": {
      "background": {
        "type": "gradient",
        "colors": ["#12001f", "#2f0a57"],
        "angle": 90
      },
      "singerTextStyles": {
        "0": {
          "fontFamily": "Inter",
          "textColor": "#00f5ff",
          "effectColor": "#ff4fd8"
        }
      }
    },
    "isDefault": false
  }'

Die Response enthält die neue presetId. Speichere sie und referenziere sie aus Projekten oder Exporten.

Kombiniere jedes POST mit einem Idempotency-Key. Wenn du denselben Key mit demselben Payload wiederverwendest, wird das ursprüngliche Preset zurückgegeben, statt ein Duplikat zu erstellen.

Gültige Preset-Felder ermitteln

Presets werden serverseitig gegen das KaraokePresetSchema validiert. Das SDK exportiert dieses Schema, sodass du es zur Laufzeit in JSON Schema konvertieren kannst:

import { KaraokePresetSchema } from "@youka/de/sdk";

const jsonSchema = KaraokePresetSchema.toJSONSchema();

Über die CLI:

youka preset schema --json

Agent-Autoren sollten dies aufrufen, bevor sie Presets verändern, damit das Modell jedes gültige Feld und jeden Werttyp kennt. Gut lesbare Referenz:

Ein Preset aktualisieren

curl -X PATCH https://api.youka.io/de/api/v1/presets/preset_abc123 \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Neon Night v2",
    "preset": {
      "singerTextStyles": {
        "0": {
          "textColor": "#ff2a2a"
        }
      }
    }
  }'

Übergebe eine beliebige Teilmenge von name und preset. Felder, die du nicht einschließt, bleiben unverändert.

Das Standard-Preset festlegen

Jeder Account hat höchstens ein Standard-Preset, das automatisch auf neue Projekte angewendet wird.

curl -X PATCH https://api.youka.io/de/api/v1/presets/preset_abc123 \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "isDefault": true
  }'

Wenn du ein neues Standard-Preset setzt, wird das vorherige automatisch zurückgesetzt.

Ein Preset anwenden

Du kannst ein Preset an drei Stellen referenzieren:

Wo	Feld
Bei der Projekterstellung	`presetId` in `POST /projects`
Jederzeit in einem Projekt	`presetId` in `PATCH /projects/{projectId}/settings`
Beim Export	`presetId` in `POST /projects/{projectId}/exports`

Beispiel beim Export:

curl -X POST https://api.youka.io/de/api/v1/projects/prj_abc/exports \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123",
    "resolution": "1080p",
    "quality": "high"
  }'

Ein Preset löschen

curl -X DELETE https://api.youka.io/de/api/v1/presets/preset_abc123 \
  -H "Authorization: Bearer yk_..." \
  -H "Idempotency-Key: delete-preset_abc123"

Das Löschen eines Presets hat keine Auswirkungen auf Projekte oder Exporte, die zuvor damit gerendert wurden. Zukünftige Exporte, die das gelöschte Preset referenzieren, schlagen fehl.

Wie es weitergeht

Render settings reference — alle geteilten Feldpfade und Enum-Werte
Media — wird aus Preset-Bodies referenziert
Project settings — ein Preset auf ein Projekt anwenden
CLI presets — derselbe Ablauf im Terminal
SDK presets — dieselben Endpunkte in TypeScript

Overview

How To

Customization

Audio

Settings

Exporting

Account

Wann du ein Preset verwenden solltest

Verwende ein Preset, wenn…

Verwende Projekteinstellungen, wenn…

Endpunkte

Ein Preset erstellen

Gültige Preset-Felder ermitteln

Ein Preset aktualisieren

Das Standard-Preset festlegen

Ein Preset anwenden

Ein Preset löschen

Wie es weitergeht

​Wann du ein Preset verwenden solltest

Verwende ein Preset, wenn…

Verwende Projekteinstellungen, wenn…

​Endpunkte

​Ein Preset erstellen

​Gültige Preset-Felder ermitteln

​Ein Preset aktualisieren

​Das Standard-Preset festlegen

​Ein Preset anwenden

​Ein Preset löschen

​Wie es weitergeht

Wann du ein Preset verwenden solltest

Endpunkte

Ein Preset erstellen

Gültige Preset-Felder ermitteln

Ein Preset aktualisieren

Das Standard-Preset festlegen

Ein Preset anwenden

Ein Preset löschen

Wie es weitergeht