Projekteinstellungen

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

Endpoints

Method	Path	Purpose
`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.

Die aktuellen Einstellungen abrufen

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

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

Einstellungen patchen

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

Apply a preset
Inline settings
Preset + overrides

curl -X PATCH https://api.youka.io/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/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/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/sdk";

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

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

Lesbare Referenzen: