> ## 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.

# Node.js SDK

> 공식 TypeScript SDK로 Node.js와 Bun에서 Youka 자동화

`@youka/sdk`는 Youka API를 위한 공식 TypeScript SDK입니다. 이를 사용해 오디오 또는 비디오에서 가라오케를 만들고, 가사와 스타일링을 커스터마이즈하며, MP4 비디오를 내보내고, Youka 워크플로를 Node.js 또는 Bun 앱에 통합할 수 있습니다.

## 설치

<CodeGroup>
  ```bash npm theme={null}
  npm install @youka/sdk
  ```

  ```bash pnpm theme={null}
  pnpm add @youka/sdk
  ```

  ```bash yarn theme={null}
  yarn add @youka/sdk
  ```

  ```bash bun theme={null}
  bun add @youka/sdk
  ```
</CodeGroup>

## 요구 사항

* Node.js 20 이상 또는 Bun 1.1+
* `YOUKA_API_KEY`에 설정된 Youka API 키( **API keys** 아래의 [online.youka.io/account](https://online.youka.io/account)에서 생성)

## 빠른 예시

```ts theme={null}
import { YoukaClient } from "@youka/ko/sdk";

const client = new YoukaClient({
  apiKey: process.env.YOUKA_API_KEY!,
});

const operation = await client.projects.create({
  source: { type: "path", path: "./song.mp3" },
  lyricsSource: { type: "transcribe" },
});

const { project } = await client.projects.wait(operation);
console.log(project.id, project.title);
```

## 레퍼런스

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/ko/sdk/quickstart">
    엔드투엔드 예시: 생성, 대기, 내보내기, 다운로드.
  </Card>

  <Card title="Authentication" icon="key" href="/ko/sdk/authentication">
    `YoukaClient`를 구성하고 API 키를 안전하게 처리하세요.
  </Card>

  <Card title="Account, credits, and billing" icon="credit-card" href="/ko/sdk/account-billing">
    신원, 잔액, 가격, 결제, 청구 포털 헬퍼.
  </Card>

  <Card title="Projects" icon="folder" href="/ko/sdk/projects">
    업로드, 생성, 목록 조회, 삭제.
  </Card>

  <Card title="Stems" icon="waveform-lines" href="/ko/sdk/stems">
    스템 분리 작업을 트리거합니다.
  </Card>

  <Card title="Lyrics sync" icon="closed-captioning" href="/ko/sdk/lyrics-sync">
    가사 동기화를 다시 실행합니다.
  </Card>

  <Card title="Exports" icon="file-video" href="/ko/sdk/exports">
    클라우드 및 로컬 내보내기 워크플로.
  </Card>

  <Card title="Tasks" icon="list-check" href="/ko/sdk/tasks">
    작업을 확인하고 완료될 때까지 대기합니다.
  </Card>

  <Card title="Presets" icon="palette" href="/ko/sdk/presets">
    재사용 가능한 렌더 구성.
  </Card>

  <Card title="Media" icon="image" href="/ko/sdk/media">
    배경, 로고, 인트로를 업로드합니다.
  </Card>

  <Card title="Project settings" icon="sliders" href="/ko/sdk/project-settings">
    프로젝트 수준의 렌더 설정.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/ko/sdk/errors">
    `YoukaRequestError` 및 `YoukaTaskError`.
  </Card>
</Columns>

## 다음 단계

* [Quickstart](/ko/sdk/quickstart) — 완성된 가라오케로 가는 가장 빠른 경로
* [API reference](/ko/api) — OpenAPI에서 자동 생성된 모든 엔드포인트
* [AI agents](/ko/agents) — 에이전트 작성자를 위한 운영 규칙