每个项目都有活动设置——裁剪、背景、字幕样式、布局——用于控制导出如何渲染。当你需要项目本地的覆盖项、但又不值得作为预设共享时，请使用项目设置。
共享的 preset、settings.style 和 settingsOverride 字段映射请参见 渲染设置参考。
| 方法 | 路径 | 用途 |
|---|
GET | /projects/{projectId}/settings | 获取当前活动的项目设置。 |
PATCH | /projects/{projectId}/settings | 应用预设、修补设置，或同时执行两者。 |
获取当前设置
curl https://api.youka.io/zh/api/v1/projects/prj_abc/settings \
-H "Authorization: Bearer yk_..."
修补设置
PATCH 接受 presetId 和 settings 的任意子集。当两者同时传入时，会先应用预设，然后将 settings 合并覆盖在其之上。
Apply a preset
Inline settings
Preset + overrides
curl -X PATCH https://api.youka.io/zh/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/zh/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/zh/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 导出了用于校验项目设置更新的 schema。可在运行时将其转换为 JSON Schema：
import { RestUpdateProjectSettingsRequestSchema } from "@youka/sdk";
const schema = RestUpdateProjectSettingsRequestSchema.toJSONSchema();
Agents 在变更项目设置之前，应先获取 SDK schema 或 OpenAPI 请求 schema，以确保始终了解当前的数据结构。
项目设置 vs 预设 vs 导出覆盖项
Youka 有三个层级可承载渲染设置：
| 层级 | 作用域 | 何时使用 |
|---|
| Preset | 账号范围 | 在多个项目中保持相同的外观。 |
| Project settings | 单个项目 | 项目特定的裁剪、背景或颜色。 |
Export settingsOverride | 仅单次导出 | 调整一次渲染效果而不影响项目本身。 |
接下来
