프로젝트

프로젝트는 카라오케 또는 가사 비디오를 위한 소스 미디어, 가사, 렌더 설정, 내보내기를 보관합니다. 카라오케 프로젝트에는 분리된 스템도 포함됩니다.

`project create`

로컬 파일 또는 URL에서 새 프로젝트를 생성합니다.

youka project create <source> [options]

string

required

로컬 파일 경로(./song.mp3) 또는 HTTP/HTTPS URL (https://example.com/song.mp4).

Options

Option	Description
`--kind <kind>`	`karaoke` 또는 `lyric-video`. 기본값은 `karaoke`.
`--title <title>`	프로젝트 제목
`--mode <mode>`	`none`, `transcribe`, 또는 `align`
`--lyrics <text>`	가사 텍스트
`--lang <code>`	언어 코드
`--sync-model <model>`	가사 동기화 모델
`--split-model <model>`	스템 분리 모델
`--max-video-quality <quality>`	URL 소스의 최대 비디오 품질: `720p`, `1080p`, `4k`, 또는 `best`
`--preset <presetId>`	프로젝트 생성 시 프리셋 적용
`--export`	프로젝트가 준비되면 내보내기 생성
`--download`	내보내기를 생성하고, 완료될 때까지 기다린 뒤 다운로드
`--output <path>`	`--download`의 출력 경로

Examples

youka project create ./song.mp3 \
  --title "My Song" \
  --mode transcribe \
  --lang en \
  --wait \
  --json

youka project create "https://example.com/song.mp4" \
  --max-video-quality 4k \
  --download \
  --output ./karaoke.mp4 \
  --json

youka project create ./song.mp3 \
  --mode align \
  --lyrics "$(cat lyrics.txt)" \
  --sync-model audioshake-alignment \
  --wait \
  --json

규칙:

가사를 전달하고 --mode를 생략하면, CLI는 기본값으로 align을 사용합니다
align에는 가사가 필요합니다
transcribe는 선택적으로 참조 가사를 받을 수 있습니다. 모델이 다른 텍스트를 반환할 수 있습니다.
none은 가사를 받지 않습니다
--kind lyric-video는 스템 분리 없이 원본 오디오를 사용하며 --split-model을 거부합니다. --kind를 생략하면 카라오케 동작을 유지합니다.
--download는 --export를 암시합니다
--max-video-quality는 HTTP/HTTPS URL 소스에만 적용됩니다. 기본값은 1080p이며, 해당 한도 내에서 사용 가능한 최고 품질을 사용하고, 플랫폼이 제한된 스트림을 노출하지 않는 경우 사용 가능한 최고 형식으로 폴백합니다.

`project list`

인증된 계정의 모든 프로젝트를 나열합니다.

youka project list
youka project list --json

`project quote`

프로젝트를 생성하지 않고, 프로젝트 생성에 필요한 크레딧을 견적 냅니다.

youka project quote <source> [options]

source는 project create와 동일한 로컬 파일 경로 또는 HTTP/HTTPS URL 형태를 받습니다. --duration이 없으면, CLI는 서버가 미디어 길이를 정확히 측정할 수 있도록 소스를 업로드하지만, 프로젝트는 생성하지 않습니다.

Options

Option	Description
`--kind <kind>`	`karaoke` 또는 `lyric-video`. 기본값은 `karaoke`.
`--title <title>`	프로젝트 제목
`--mode <mode>`	`none`, `transcribe`, 또는 `align`
`--lyrics <text>`	`align`에는 필수 텍스트, `transcribe`에는 선택 가이드
`--lang <code>`	언어 코드
`--sync-model <model>`	가사 동기화 모델
`--split-model <model>`	스템 분리 모델
`--max-video-quality <quality>`	URL 소스의 최대 비디오 품질: `720p`, `1080p`, `4k`, 또는 `best`
`--duration <seconds>`	소스를 업로드하지 않고 알려진 길이로 견적

Examples:

youka project quote ./song.mp3 --mode transcribe --json
youka project quote https://example.com/song.mp4 --max-video-quality 4k --mode transcribe --json
youka project quote ./song.mp3 --duration 210 --mode none --json

`project show`

정규화된 state, pendingOperation, 스템, 설정, 내보내기를 포함한 현재 프로젝트 상태를 가져옵니다.

youka project show <projectId>

string

required

project create가 반환한 프로젝트 ID.

`project wait`

프로젝트가 종료 상태에 도달할 때까지 폴링합니다.

youka project wait <projectId> --json

`project delete`

프로젝트와 연결된 모든 스템, 가사, 내보내기를 삭제합니다.

youka project delete <projectId> --idempotency-key delete-<projectId>

삭제는 영구적입니다. 재시도를 안전하게 하려면 --idempotency-key를 전달하세요.

`project sync`

기존 프로젝트에서 가사 전사 또는 정렬을 다시 실행합니다.

youka project sync <projectId> [options]

Option	Description
`--mode <mode>`	`transcribe` 또는 `align`
`--text <text>`	가사 텍스트
`--lang <code>`	언어 코드
`--sync-model <model>`	가사 동기화 모델

Example:

youka project sync $PROJECT_ID \
  --mode align \
  --text "$(cat lyrics.txt)" \
  --wait \
  --json

`project separate`

기존 프로젝트에서 스템 분리를 다시 실행합니다.

youka project separate <projectId> [--split-model <model>]

Example:

youka project separate $PROJECT_ID --split-model audioshakeai --wait --json

`project settings`

활성 프로젝트 설정을 읽거나 업데이트합니다.

youka project settings <projectId>
youka project settings <projectId> --preset <presetId> --body ./settings.json

--preset과 --body가 모두 없으면 명령은 현재 설정을 반환합니다. 둘 중 하나라도 있으면 업데이트를 수행합니다. Examples:

youka project settings $PROJECT_ID --json

youka project settings $PROJECT_ID \
  --preset preset_abc123 \
  --body ./project-settings.json \
  --json

`project stem list`

프로젝트의 스템을 나열합니다.

youka project stem list <projectId>
youka project stem list <projectId> --json

`project stem download`

하나 이상의 스템 파일을 디스크로 다운로드합니다. 스템은 저장된 원본 형식 그대로 다운로드되며, CLI는 트랜스코딩하지 않습니다.

youka project stem download <projectId> <stemId> --output ./stems
youka project stem download <projectId> --type instrumental --output ./stems
youka project stem download <projectId> --type original --type backing-vocals --type vocals --output ./stems
youka project stem download <projectId> --all --output ./stems

지원되는 --type 값은 original, instrumental, vocals, backing_vocals입니다. 또한 CLI는 별칭으로 backing-vocals, backingVocals, backingvocals도 허용합니다.

What’s next

Exports - 완성된 카라오케를 렌더링합니다
Presets - 재사용 가능한 렌더 구성 관리
Render settings reference - 공통 프리셋 및 설정 필드

Capabilities, versions, and timings

youka capabilities --json는 모델 ID, 지원되는 워크플로, 텍스트 처리, 언어 지원, 계정 자격을 반환합니다. Wav2Vec2는 정렬 모델입니다. ElevenLabs Scribe는 전사 모델입니다. 분리된 보컬이 필요한 모델은 보컬을 생성하는 분리 모델이 있는 카라오케 워크플로가 필요합니다.

youka capabilities --json
youka project create ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project quote ./song.wav --kind lyric-video --mode transcribe --sync-model elevenlabs-transcription --json
youka project versions proj_example --json
youka project settings proj_example --version-id ver_example --json
youka project timings list proj_example --json
youka project timings get proj_example aln_example --json
youka project timings import proj_example aln_example --body corrected-request.json --json
youka project timings select proj_example aln_example --expected-revision "$ALIGNMENT_REVISION" --expected-selection-revision "$SELECTION_REVISION" --json

project settings --version-id는 선택한 버전을 읽거나 업데이트합니다. 플래그를 생략하면 기본(primary) 버전을 사용합니다. 타이밍 import는 처리 작업이나 크레딧 홀드 없이 전체 정렬을 대체합니다. JSON body에는 alignment와 expectedRevision이 포함됩니다. 원자적(save-and-select) 저장 및 선택에는 select: true와 expectedSelectionRevision도 필요합니다. 오래된 토큰은 HTTP 409를 반환합니다. 다른 편집을 시도하기 전에 현재 값을 가져와 비교하세요. 요청 파일, 타이밍 검증, 재개 가능한 카탈로그 처리에 대해서는 Automate lyric videos를 참고하세요.

Overview

How To

Customization

Audio

Settings

Exporting

Account

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

What’s next

Capabilities, versions, and timings

​project create

​Options

​Examples

​project list

​project quote

​Options

​project show

​project wait

​project delete

​project sync

​project separate

​project settings

​project stem list

​project stem download

​What’s next

​Capabilities, versions, and timings

`project create`

Options

Examples

`project list`

`project quote`

Options

`project show`

`project wait`

`project delete`

`project sync`

`project separate`

`project settings`

`project stem list`

`project stem download`

What’s next

Capabilities, versions, and timings