Preset

Quản lý các cấu hình render có thể tái sử dụng

Preset là một cấu hình render có thể tái sử dụng — nền, kiểu phụ đề, bố cục và các thiết lập hình ảnh khác — mà bạn có thể áp dụng cho bất kỳ project hoặc export nào. Preset rất phù hợp khi bạn cần một phong cách nhất quán trên nhiều track.

Xem Render settings reference để biết đầy đủ cấu trúc preset và mọi tùy chọn được hỗ trợ bởi enum.

preset schema

Trả về JSON Schema cho các thiết lập preset. Dùng cái này để khám phá các field hợp lệ trước khi tạo hoặc cập nhật một preset.

youka preset schema --json

Agents nên gọi preset schema trước khi chỉnh sửa preset để biết chính xác tên field và kiểu giá trị.

preset list

Liệt kê tất cả preset thuộc tài khoản đã xác thực.

youka preset list --json

preset show

Lấy một preset theo ID.

youka preset show <presetId> --json

preset create

Tạo một preset mới.

youka preset create [options]

Options

Option	Description
--name <name>	Tên preset
--default	Đánh dấu preset mới là preset mặc định
--body <file|->	Đọc toàn bộ request body từ file hoặc stdin

Request body nên chứa toàn bộ object preset. Với payload lớn, nên dùng --body thay vì JSON inline.

Examples

from-file

youka preset create \
  --name "Neon Night" \
  --body ./neon-preset.json \
  --json

Các flag của CLI sẽ ghi đè các field tương ứng từ --body.

preset update

Cập nhật một preset hiện có.

youka preset update <presetId> [options]

Option	Description
--name <name>	Tên mới
--body <file|->	Toàn bộ request body từ file hoặc stdin

Ví dụ:

youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json

preset delete

Xóa một preset theo ID.

youka preset delete <presetId> --json

Việc xóa một preset không xóa các project hoặc export đã được render trước đó bằng preset này. Các export trong tương lai tham chiếu đến preset đã bị xóa sẽ thất bại.

preset default

Lấy hoặc đặt preset mặc định.

youka preset default --json
youka preset default <presetId> --json

Khi không có đối số, lệnh trả về preset mặc định hiện tại hoặc null. Khi có preset ID, lệnh sẽ đặt preset đó làm mặc định.

Áp dụng một preset

Áp dụng một preset cho project hoặc export bằng --preset:

on-create

youka project create ./song.mp3 --preset $PRESET_ID --wait

Tiếp theo

• Render settings reference - tất cả các field preset dùng chung
• Projects - áp dụng preset vào thiết lập project
• Exports - áp dụng preset tại thời điểm render
• Media - media có thể tái sử dụng được preset tham chiếu