> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Youka 문서

> Youka 웹 앱, 데스크톱 앱, CLI, API, SDK로 노래방 영상을 만드는 방법을 위한 가이드와 레퍼런스

Youka는 어떤 노래든 노래방 영상으로 만들어 줍니다. 이 사이트는 웹 앱이나 데스크톱 앱에서의 클릭 기반 사용부터, 커맨드 라인으로 자동화하는 방식, 또는 API와 SDK를 통해 여러분의 제품에 임베드하는 방식까지 Youka를 사용하는 모든 방법을 다룹니다.

## Youka란?

Youka는 어떤 오디오 파일이나 URL에서도 보컬을 분리하고, 가사를 단어 단위로 동기화한 뒤, 편집·내보내기·공유할 수 있는 완성된 노래방 영상을 렌더링합니다. 동일한 파이프라인을 브라우저, 데스크톱, 그리고 공개 API에서도 사용할 수 있습니다.

## 무엇을 사용하면 좋을까요?

<Columns cols={2}>
  <Card title="Web App" icon="globe" href="/ko/web">
    브라우저에서 노래방을 만들고 편집하세요. 빠르게 한 번 만들 때,
    브라우저 기반 워크플로, 그리고 Studio 편집기에 가장 적합합니다.
  </Card>

  <Card title="Desktop App" icon="display" href="/ko/desktop">
    컴퓨터에 Youka를 설치하세요. 파일이나 URL로 노래방을 만들고,
    키보드 단축키로 편집하며, 로컬 MP4로 내보내기에 가장 적합합니다.
  </Card>

  <Card title="CLI" icon="terminal" href="/ko/cli">
    스크립트로 전체 파이프라인을 자동화하세요. 배치 작업과 로컬
    렌더 워크플로에 가장 적합합니다.
  </Card>

  <Card title="SDK" icon="code" href="/ko/sdk">
    Node.js 또는 Bun에서 Youka를 호출하세요. 여러분의 제품에 노래방 기능을
    구축하는 데 가장 적합합니다.
  </Card>

  <Card title="API" icon="server" href="/ko/api">
    어떤 언어에서든 공개 REST API를 호출하세요. 서비스 간
    통합에 가장 적합합니다.
  </Card>

  <Card title="AI Agents" icon="robot" href="/ko/agents">
    에이전트가 Youka를 자동으로 구동할 때의 운영 규칙과 워크플로 패턴입니다.
  </Card>
</Columns>

## Youka가 처음이신가요?

<Steps>
  <Step title="사용 환경 선택">
    처음 사용하는 대부분의 사용자는 [web app](/ko/web/create-karaoke)에서 시작합니다. 설치형 워크플로를 원한다면 [desktop
    app](/ko/desktop/youtube-to-karaoke)에서 시작하세요. 개발자는 보통
    [CLI](/ko/cli)부터 시작합니다.
  </Step>

  <Step title="첫 노래방 만들기">
    파일을 업로드하거나 URL을 붙여넣으세요. Youka가 스템을 분리하고, 가사를 동기화한 뒤,
    미리보기를 렌더링합니다.
  </Step>

  <Step title="외형 커스터마이즈">
    배경을 선택하고, 자막 스타일을 조정하고, 곡을 트리밍하세요.
  </Step>

  <Step title="내보내기">
    완성된 영상을 다운로드하거나 재생 링크를 공유하세요.
  </Step>
</Steps>

## 인기 가이드

* [첫 노래방 만들기 (web)](/ko/web/create-karaoke) — 노래를 업로드하고 몇 분 만에 내보내기
* [Studio 편집기 사용하기](/ko/web/using-studio) — 브라우저에서 가사, 타이밍, 레이아웃, 스타일링 편집
* [동영상 URL을 노래방으로](/ko/desktop/youtube-to-karaoke) — 어떤 온라인 동영상이든 노래방 트랙으로 변환
* [가사 동기화 수정](/ko/desktop/fix-lyrics-sync) — 타이밍이 어긋났을 때의 해결 방법
* [CLI 빠른 시작](/ko/cli) — 터미널에서 전체 파이프라인 자동화
* [SDK 빠른 시작](/ko/sdk/quickstart) — 몇 줄로 Node.js에서 프로젝트 생성