Preset

Un preset è una configurazione di rendering riutilizzabile — sfondo, stile dei sottotitoli, layout — che puoi applicare a qualsiasi progetto o export. Usa i preset quando vuoi un aspetto coerente su molte tracce. Vedi Render settings reference per la forma completa di preset e tutte le opzioni basate su enum.

Quando usare un preset

Usa un preset quando…

Vuoi lo stesso aspetto su molti progetti e devi aggiornarlo in un unico posto.

Usa le impostazioni del progetto quando…

Ti servono override locali al progetto che non vale la pena condividere.

Endpoint

Method	Path	Purpose
`GET`	`/presets`	Elenca i preset per l’account autenticato.
`POST`	`/presets`	Crea un nuovo preset.
`GET`	`/presets/{presetId}`	Recupera un singolo preset.
`PATCH`	`/presets/{presetId}`	Aggiorna nome, body o imposta come predefinito.
`DELETE`	`/presets/{presetId}`	Elimina un preset.

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

Crea un preset

curl -X POST https://api.youka.io/it/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
  }'

La risposta include il nuovo presetId. Conservalo e usalo come riferimento nei progetti o negli export.

Abbina ogni POST a una chiave di idempotenza. Riutilizzare la stessa chiave con lo stesso payload restituisce il preset originale invece di crearne un duplicato.

Scopri i campi validi del preset

I preset vengono validati lato server rispetto a KaraokePresetSchema. L’SDK esporta questo schema, così puoi convertirlo in JSON Schema a runtime:

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

const jsonSchema = KaraokePresetSchema.toJSONSchema();

Dalla CLI:

youka preset schema --json

Gli autori di agent dovrebbero chiamarlo prima di modificare i preset, così il modello conosce ogni campo valido e il tipo di valore. Riferimento leggibile:

Aggiorna un preset

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

Passa qualsiasi sottoinsieme di name e preset. I campi che non includi restano invariati.

Imposta il preset predefinito

Ogni account ha al massimo un preset predefinito, applicato automaticamente ai nuovi progetti.

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

Impostare un nuovo predefinito disattiva automaticamente quello precedente.

Applica un preset

Fai riferimento a un preset in tre punti:

Dove	Campo
Alla creazione del progetto	`presetId` in `POST /projects`
In qualunque momento su un progetto	`presetId` in `PATCH /projects/{projectId}/settings`
Al momento dell’export	`presetId` in `POST /projects/{projectId}/exports`

Esempio su export:

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

Elimina un preset

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

Eliminare un preset non influisce su progetti o export che sono stati renderizzati in precedenza con esso. I futuri export che fanno riferimento al preset eliminato falliranno.

Cosa fare dopo

Render settings reference — tutti i percorsi dei campi condivisi e i valori enum
Media — referenziati dai body dei preset
Project settings — applica un preset a un progetto
CLI presets — lo stesso flusso dal terminale
SDK presets — gli stessi endpoint in TypeScript

Overview

How To

Customization

Audio

Settings

Exporting

Account

Quando usare un preset

Usa un preset quando…

Usa le impostazioni del progetto quando…

Endpoint

Crea un preset

Scopri i campi validi del preset

Aggiorna un preset

Imposta il preset predefinito

Applica un preset

Elimina un preset

Cosa fare dopo

​Quando usare un preset

Usa un preset quando…

Usa le impostazioni del progetto quando…

​Endpoint

​Crea un preset

​Scopri i campi validi del preset

​Aggiorna un preset

​Imposta il preset predefinito

​Applica un preset

​Elimina un preset

​Cosa fare dopo

Quando usare un preset

Endpoint

Crea un preset

Scopri i campi validi del preset

Aggiorna un preset

Imposta il preset predefinito

Applica un preset

Elimina un preset

Cosa fare dopo