Projekteinstellungen

Jedes Projekt hat aktive Einstellungen — Trim, Hintergrund, Untertitelstil, Layout — die steuern, wie Exporte gerendert werden. Verwende Projekteinstellungen, wenn du projektlokale Overrides brauchst, die sich nicht als Preset zum Teilen lohnen. 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/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.

Apply a preset
Inline settings
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 an 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 immer die aktuelle Struktur kennen.

Menschenlesbare Referenz: