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

> Tự động hóa Youka từ Node.js và Bun với TypeScript SDK chính thức

`@youka/sdk` là TypeScript SDK chính thức cho Youka API. Dùng nó để tạo karaoke từ audio hoặc video, tùy chỉnh lời bài hát và styling, xuất video MP4, và tích hợp các workflow Youka vào ứng dụng Node.js hoặc Bun.

## Cài đặt

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

## Yêu cầu

* Node.js 20 trở lên, hoặc Bun 1.1+
* Một Youka API key trong `YOUKA_API_KEY` (tạo tại [online.youka.io/account](https://online.youka.io/account) dưới mục **API keys**)

## Ví dụ nhanh

```ts theme={null}
import { YoukaClient } from "@youka/vi/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);
```

## Tham khảo

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/vi/sdk/quickstart">
    Ví dụ end-to-end: tạo, chờ, xuất, tải xuống.
  </Card>

  <Card title="Authentication" icon="key" href="/vi/sdk/authentication">
    Cấu hình `YoukaClient` và xử lý API key an toàn.
  </Card>

  <Card title="Account, credits, and billing" icon="credit-card" href="/vi/sdk/account-billing">
    Trợ giúp về định danh, số dư, giá, thanh toán, và cổng quản lý hóa đơn.
  </Card>

  <Card title="Projects" icon="folder" href="/vi/sdk/projects">
    Upload, tạo, liệt kê, và xóa.
  </Card>

  <Card title="Stems" icon="waveform-lines" href="/vi/sdk/stems">
    Kích hoạt các tác vụ tách stem.
  </Card>

  <Card title="Lyrics sync" icon="closed-captioning" href="/vi/sdk/lyrics-sync">
    Chạy lại đồng bộ lời bài hát.
  </Card>

  <Card title="Exports" icon="file-video" href="/vi/sdk/exports">
    Workflow xuất trên cloud và local.
  </Card>

  <Card title="Tasks" icon="list-check" href="/vi/sdk/tasks">
    Kiểm tra tác vụ và chờ hoàn tất.
  </Card>

  <Card title="Presets" icon="palette" href="/vi/sdk/presets">
    Cấu hình render có thể tái sử dụng.
  </Card>

  <Card title="Media" icon="image" href="/vi/sdk/media">
    Upload nền, logo, và intro.
  </Card>

  <Card title="Project settings" icon="sliders" href="/vi/sdk/project-settings">
    Cài đặt render ở cấp dự án.
  </Card>

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

## Tiếp theo

* [Quickstart](/vi/sdk/quickstart) — con đường ngắn nhất để có một karaoke hoàn chỉnh
* [API reference](/vi/api) — mọi endpoint, được tự động tạo từ OpenAPI
* [AI agents](/vi/agents) — quy tắc vận hành dành cho tác giả agent