Impostazioni del progetto

Ogni progetto ha impostazioni attive — trim, sfondo, stile dei sottotitoli, layout — che controllano come vengono renderizzati gli export. Usa le impostazioni del progetto quando vuoi override locali al progetto che non vale la pena condividere come preset. Vedi Render settings reference per la mappa dei campi condivisi preset, settings.style e settingsOverride.

Endpoint

Metodo	Percorso	Scopo
`GET`	`/projects/{projectId}/settings`	Recupera le impostazioni attive del progetto.
`PATCH`	`/projects/{projectId}/settings`	Applica un preset, modifica le impostazioni, o entrambi.

Gli schemi completi di richiesta e risposta sono nella API reference.

Recupera le impostazioni correnti

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

Restituisce l’intero set di impostazioni attive del progetto, incluso qualsiasi preset applicato.

Modifica le impostazioni

PATCH accetta qualsiasi sottoinsieme di presetId e settings. Quando vengono passati entrambi, il preset viene applicato per primo e poi settings viene unito sopra.

Applica un preset
Impostazioni inline
Preset + override

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 }
    }
  }'

Scopri i campi validi

L’SDK esporta lo schema che valida gli aggiornamenti delle impostazioni del progetto. Convertirlo in JSON Schema a runtime:

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

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

Gli agenti dovrebbero recuperare lo schema dell’SDK o lo schema di richiesta OpenAPI prima di modificare le impostazioni del progetto, così da conoscere sempre la struttura corrente.

Riferimento leggibile: