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

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

Endpoints

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

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

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

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

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

Обновить настройки

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

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

curl -X PATCH https://api.youka.io/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/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/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 перед изменением настроек проекта, чтобы всегда знать актуальную структуру.

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