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

MethodPathPurpose
GET/presetsLista los preajustes de la cuenta autenticada.
POST/presetsCrea 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:
WhereField
Al crear el proyectopresetId en POST /projects
En cualquier momento en un proyectopresetId en PATCH /projects/{projectId}/settings
En el momento de exportarpresetId 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