Cài đặt dự án

Mỗi dự án đều có các cài đặt đang hoạt động — trim, background, kiểu subtitle, layout — quyết định cách các bản xuất (export) được render. Hãy dùng cài đặt dự án khi bạn muốn ghi đè theo từng dự án (project-local) mà không đáng để chia sẻ dưới dạng preset. Xem Render settings reference để biết bảng ánh xạ các trường dùng chung cho preset, settings.style, và settingsOverride.

Endpoints

Method	Path	Purpose
`GET`	`/projects/{projectId}/settings`	Lấy các cài đặt dự án đang hoạt động.
`PATCH`	`/projects/{projectId}/settings`	Áp dụng preset, cập nhật cài đặt, hoặc cả hai.

Schema đầy đủ cho request và response có trong API reference.

Lấy cài đặt hiện tại

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

Trả về toàn bộ cài đặt dự án đang hoạt động, bao gồm cả preset (nếu đang được áp dụng).

Cập nhật cài đặt

PATCH chấp nhận bất kỳ tập con nào của presetId và settings. Khi truyền cả hai, preset sẽ được áp dụng trước, sau đó settings sẽ được merge chồng lên.

Áp dụng preset
Cài đặt inline
Preset + ghi đè

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

Tìm các trường hợp lệ

SDK export schema dùng để validate các cập nhật cài đặt dự án. Hãy chuyển nó sang JSON Schema tại runtime:

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

const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();

Agents nên lấy SDK schema hoặc OpenAPI request schema trước khi thay đổi cài đặt dự án để luôn nắm được cấu trúc hiện tại.

Tài liệu tham khảo dễ đọc: