Preajustes

Un preajuste es una configuración de render reutilizable — fondo, estilo de subtítulos, diseño — que puedes aplicar a cualquier proyecto o exportación. Usa preajustes cuando quieras una apariencia consistente en muchas pistas. Consulta Render settings reference para ver la forma completa de preset y todas las opciones respaldadas por enums.

Cuándo usar un preajuste

Usa un preajuste cuando…

Quieres la misma apariencia en muchos proyectos y necesitas actualizarla en un solo lugar.

Usa la configuración del proyecto cuando…

Necesitas ajustes locales del proyecto que no vale la pena compartir.

Endpoints

Method	Path	Purpose
`GET`	`/presets`	Lista los preajustes de la cuenta autenticada.
`POST`	`/presets`	Crea un nuevo preajuste.
`GET`	`/presets/{presetId}`	Obtiene un único preajuste.
`PATCH`	`/presets/{presetId}`	Actualiza el nombre, el cuerpo o lo fija por defecto.
`DELETE`	`/presets/{presetId}`	Elimina un preajuste.

Los esquemas completos de solicitud y respuesta están disponibles en API reference en la barra lateral.

Crear un preajuste

curl -X POST https://api.youka.io/es/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 respuesta incluye el nuevo presetId. Guárdalo y haz referencia a él desde proyectos o exportaciones.

Acompaña cada POST con una clave de idempotencia. Reutilizar la misma clave con el mismo payload devuelve el preajuste original en lugar de crear un duplicado.

Descubrir campos válidos del preajuste

Los preajustes se validan del lado del servidor contra KaraokePresetSchema. El SDK exporta este esquema para que puedas convertirlo a JSON Schema en tiempo de ejecución:

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

const jsonSchema = KaraokePresetSchema.toJSONSchema();

Desde el CLI:

youka preset schema --json

Quienes escriben agentes deberían llamar a esto antes de modificar preajustes para que el modelo conozca cada campo válido y el tipo de valor. Referencia legible:

Actualizar un preajuste

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

Pasa cualquier subconjunto de name y preset. Los campos que no incluyas se mantienen sin cambios.

Establecer el preajuste predeterminado

Cada cuenta tiene como máximo un preajuste predeterminado, que se aplica automáticamente a los proyectos nuevos.

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

Establecer un nuevo valor predeterminado desactiva automáticamente el anterior.

Aplicar un preajuste

Haz referencia a un preajuste en tres lugares:

Where	Field
Al crear el proyecto	`presetId` en `POST /projects`
En cualquier momento en un proyecto	`presetId` en `PATCH /projects/{projectId}/settings`
En el momento de exportar	`presetId` en `POST /projects/{projectId}/exports`

Ejemplo al exportar:

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

Eliminar un preajuste

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

Eliminar un preajuste no afecta a los proyectos o exportaciones que se hayan renderizado previamente con él. Las exportaciones futuras que hagan referencia al preajuste eliminado fallarán.

Qué sigue

Render settings reference — todas las rutas de campos compartidos y valores de enum
Media — referenciado desde los cuerpos de preajuste
Project settings — aplica un preajuste a un proyecto
CLI presets — el mismo flujo desde la terminal
SDK presets — los mismos endpoints en TypeScript

Overview

How To

Customization

Audio

Settings

Exporting

Account

Cuándo usar un preajuste

Usa un preajuste cuando…

Usa la configuración del proyecto cuando…

Endpoints

Crear un preajuste

Descubrir campos válidos del preajuste

Actualizar un preajuste

Establecer el preajuste predeterminado

Aplicar un preajuste

Eliminar un preajuste

Qué sigue

​Cuándo usar un preajuste

Usa un preajuste cuando…

Usa la configuración del proyecto cuando…

​Endpoints

​Crear un preajuste

​Descubrir campos válidos del preajuste

​Actualizar un preajuste

​Establecer el preajuste predeterminado

​Aplicar un preajuste

​Eliminar un preajuste

​Qué sigue

Cuándo usar un preajuste

Endpoints

Crear un preajuste

Descubrir campos válidos del preajuste

Actualizar un preajuste

Establecer el preajuste predeterminado

Aplicar un preajuste

Eliminar un preajuste

Qué sigue