Projekteinstellungen

Jedes Projekt hat aktive Einstellungen — Trim, Hintergrund, Untertitelstil, Layout — die steuern, wie Exporte gerendert werden. Verwende Projekteinstellungen, wenn du projektlokale Overrides möchtest, die sich nicht als Preset zu teilen lohnen. Siehe Referenz für Render-Einstellungen für die gemeinsame Feldzuordnung von preset, settings.style und settingsOverride.

Endpoints

Method	Path	Zweck
`GET`	`/projects/{projectId}/settings`	Die aktiven Projekteinstellungen abrufen.
`PATCH`	`/projects/{projectId}/settings`	Ein Preset anwenden, Einstellungen patchen oder beides.

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

Aktuelle Einstellungen abrufen

curl https://api.youka.io/de/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..."

Gibt die vollständigen aktiven Projekteinstellungen zurück, einschließlich eines ggf. angewendeten Presets.

Einstellungen patchen

PATCH akzeptiert jede Teilmenge von presetId und settings. Wenn beide übergeben werden, wird zuerst das Preset angewendet und anschließend werden settings darüber gemergt.

Ein Preset anwenden
Inline-Einstellungen
Preset + Overrides

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

curl -X PATCH https://api.youka.io/de/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 },
      "style": {
        "background": {
          "type": "color",
          "color": "#101010"
        }
      }
    }
  }'

curl -X PATCH https://api.youka.io/de/api/v1/projects/prj_abc/settings \
  -H "Authorization: Bearer yk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "preset_abc123",
    "settings": {
      "trim": { "startSeconds": 5, "endSeconds": 180 }
    }
  }'

Gültige Felder ermitteln

Das SDK exportiert das Schema, das Updates der Projekteinstellungen validiert. Wandle es zur Laufzeit in JSON Schema um:

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

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

Agents sollten das SDK-Schema oder das OpenAPI-Request-Schema abrufen, bevor sie Projekteinstellungen mutieren, damit sie die aktuelle Struktur immer kennen.

Referenz (für Menschen lesbar):