Настройки проекта

У каждого проекта есть активные настройки — обрезка, фон, стиль субтитров, макет — которые управляют тем, как рендерятся экспорты. Используйте настройки проекта, когда вам нужны локальные для проекта переопределения, которыми не имеет смысла делиться как пресетом. См. Справочник по настройкам рендера для общей карты полей preset, settings.style и settingsOverride.

Эндпоинты

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	Получить активные настройки проекта.
`PATCH`	`/projects/{projectId}/settings`	Применить пресет, изменить настройки или и то, и другое.

Полные схемы запросов и ответов приведены в API reference.

Получить текущие настройки

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

Возвращает полный набор активных настроек проекта, включая любой применённый пресет.

Изменить настройки

PATCH принимает любой поднабор presetId и settings. Если переданы оба, сначала применяется пресет, затем поверх него сливаются settings.

Применить пресет
Встроенные настройки
Пресет + переопределения

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

Узнать допустимые поля

SDK экспортирует схему, которая валидирует обновления настроек проекта. Преобразуйте её в JSON Schema во время выполнения:

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

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

Агентам следует получать схему SDK или схему запроса OpenAPI перед изменением настроек проекта, чтобы всегда знать актуальную структуру.

Справочник в удобочитаемом виде: