프로젝트 설정

모든 프로젝트에는 내보내기가 렌더링되는 방식을 제어하는 활성 설정(트림, 배경, 자막 스타일, 레이아웃)이 있습니다. 프리셋으로 공유할 가치가 없을 정도로 프로젝트 로컬 재정의가 필요할 때 프로젝트 설정을 사용하세요. 공유되는 preset, settings.style, settingsOverride 필드 맵은 Render settings reference를 참고하세요.

엔드포인트

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	활성 프로젝트 설정을 가져옵니다.
`PATCH`	`/projects/{projectId}/settings`	프리셋 적용, 설정 패치 또는 둘 다 수행.

전체 요청 및 응답 스키마는 API reference에 있습니다.

현재 설정 가져오기

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

적용된 프리셋을 포함하여 전체 활성 프로젝트 설정을 반환합니다.

설정 패치하기

PATCH는 presetId와 settings의 어떤 하위 집합이든 허용합니다. 둘 다 전달되면 먼저 프리셋이 적용되고 그 위에 settings가 병합됩니다.

프리셋 적용
인라인 설정
프리셋 + 재정의

curl -X PATCH https://api.youka.io/ko/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/ko/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/ko/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 요청 스키마를 가져와서 항상 현재 형태를 알 수 있도록 해야 합니다.

사람이 읽기 쉬운 레퍼런스: