Skip to main content
프리셋은 배경, 자막 스타일, 레이아웃, 기타 시각적 설정 등 재사용 가능한 렌더 구성으로, 어떤 프로젝트나 내보내기에도 적용할 수 있습니다. 프리셋은 여러 트랙에 걸쳐 일관된 룩을 유지해야 할 때 이상적입니다. preset의 전체 형태와 enum 기반 옵션을 모두 보려면 Render settings reference를 확인하세요.

preset schema

프리셋 설정에 대한 JSON Schema를 반환합니다. 프리셋을 생성하거나 업데이트하기 전에 유효한 필드를 확인하는 데 사용하세요.
youka preset schema --json
에이전트는 프리셋을 변경하기 전에 preset schema를 호출해 정확한 필드명과 값 타입을 알아야 합니다.

preset list

인증된 계정이 소유한 모든 프리셋을 나열합니다.
youka preset list --json

preset show

ID로 단일 프리셋을 가져옵니다.
youka preset show <presetId> --json

preset create

새 프리셋을 생성합니다.
youka preset create [options]

Options

OptionDescription
--name <name>프리셋 이름
--default새 프리셋을 기본값으로 표시
--body <file|->파일 또는 stdin에서 전체 요청 본문을 읽습니다
요청 본문에는 전체 preset 객체가 포함되어야 합니다. 페이로드가 큰 경우 인라인 JSON 대신 --body를 사용하는 것을 권장합니다.

Examples

youka preset create \
  --name "Neon Night" \
  --body ./neon-preset.json \
  --json
CLI 플래그는 --body의 동일한 필드를 덮어씁니다.

preset update

기존 프리셋을 업데이트합니다.
youka preset update <presetId> [options]
OptionDescription
--name <name>새 이름
--body <file|->파일 또는 stdin에서 전체 요청 본문
Example:
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json

preset delete

ID로 프리셋을 삭제합니다.
youka preset delete <presetId> --json
프리셋을 삭제해도 이전에 해당 프리셋으로 렌더링된 프로젝트나 내보내기는 삭제되지 않습니다. 삭제된 프리셋을 참조하는 이후 내보내기는 실패합니다.

preset default

기본 프리셋을 가져오거나 설정합니다.
youka preset default --json
youka preset default <presetId> --json
인자가 없으면 현재 기본 프리셋 또는 null을 반환합니다. 프리셋 ID를 제공하면 해당 프리셋을 기본값으로 설정합니다.

프리셋 적용

--preset으로 프로젝트 또는 내보내기에 프리셋을 적용합니다:
youka project create ./song.mp3 --preset $PRESET_ID --wait

다음 단계

  • Render settings reference - 공유되는 모든 프리셋 필드
  • Projects - 프로젝트 설정에 프리셋 적용
  • Exports - 렌더 시점에 프리셋 적용
  • Media - 프리셋에서 참조하는 재사용 가능한 미디어