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

> Automatisiere Youka aus Node.js und Bun mit dem offiziellen TypeScript SDK

`@youka/sdk` ist das offizielle TypeScript SDK für die Youka API. Verwende es, um aus Audio oder Video Karaoke zu erstellen, Lyrics und Styling anzupassen, MP4-Videos zu exportieren und Youka-Workflows in Node.js- oder Bun-Apps zu integrieren.

## Installieren

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

## Anforderungen

* Node.js 20 oder neuer, oder Bun 1.1+
* Ein Youka API key in `YOUKA_API_KEY` (erstelle einen unter [online.youka.io/account](https://online.youka.io/account) unter **API keys**)

## Schnelles Beispiel

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

## Referenz

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/de/sdk/quickstart">
    End-to-end-Beispiel: erstellen, warten, exportieren, herunterladen.
  </Card>

  <Card title="Authentication" icon="key" href="/de/sdk/authentication">
    `YoukaClient` konfigurieren und API keys sicher handhaben.
  </Card>

  <Card title="Account, credits, and billing" icon="credit-card" href="/de/sdk/account-billing">
    Identity-, Balance-, Pricing-, Checkout- und Billing-Portal-Helper.
  </Card>

  <Card title="Projects" icon="folder" href="/de/sdk/projects">
    Uploads, Erstellung, Auflisten und Löschen.
  </Card>

  <Card title="Stems" icon="waveform-lines" href="/de/sdk/stems">
    Stem-Separation-Tasks auslösen.
  </Card>

  <Card title="Lyrics sync" icon="closed-captioning" href="/de/sdk/lyrics-sync">
    Lyrics-Synchronisierung erneut ausführen.
  </Card>

  <Card title="Exports" icon="file-video" href="/de/sdk/exports">
    Cloud- und lokale Export-Workflows.
  </Card>

  <Card title="Tasks" icon="list-check" href="/de/sdk/tasks">
    Tasks prüfen und auf den Abschluss warten.
  </Card>

  <Card title="Presets" icon="palette" href="/de/sdk/presets">
    Wiederverwendbare Render-Konfigurationen.
  </Card>

  <Card title="Media" icon="image" href="/de/sdk/media">
    Hintergründe, Logos und Intros hochladen.
  </Card>

  <Card title="Project settings" icon="sliders" href="/de/sdk/project-settings">
    Render-Einstellungen auf Projektebene.
  </Card>

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

## Was als Nächstes

* [Quickstart](/de/sdk/quickstart) — der schnellste Weg zu einem fertigen Karaoke
* [API reference](/de/api) — jeder Endpoint, automatisch aus OpenAPI generiert
* [AI agents](/de/agents) — Betriebsregeln für Agent-Autoren