Skip to main content
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

MethodPathPurpose
GET/presetsElenca i preset per l’account autenticato.
POST/presetsCrea 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:
DoveCampo
Alla creazione del progettopresetId in POST /projects
In qualunque momento su un progettopresetId in PATCH /projects/{projectId}/settings
Al momento dell’exportpresetId 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