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

> Automatizza Youka da Node.js e Bun con l'SDK TypeScript ufficiale

`@youka/sdk` è l'SDK TypeScript ufficiale per l'API Youka. Usalo per creare karaoke da audio o video, personalizzare testi e stile, esportare video MP4 e integrare i flussi di lavoro Youka in app Node.js o Bun.

## Installazione

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

## Requisiti

* Node.js 20 o successivo, oppure Bun 1.1+
* Una chiave API Youka in `YOUKA_API_KEY` (creane una su [online.youka.io/account](https://online.youka.io/account) in **API keys**)

## Esempio rapido

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

## Riferimento

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/it/sdk/quickstart">
    Esempio end-to-end: crea, attendi, esporta, scarica.
  </Card>

  <Card title="Authentication" icon="key" href="/it/sdk/authentication">
    Configura `YoukaClient` e gestisci le chiavi API in sicurezza.
  </Card>

  <Card title="Account, credits, and billing" icon="credit-card" href="/it/sdk/account-billing">
    Helper per identità, saldo, prezzi, checkout e portale di fatturazione.
  </Card>

  <Card title="Projects" icon="folder" href="/it/sdk/projects">
    Caricamenti, creazione, elenco ed eliminazione.
  </Card>

  <Card title="Stems" icon="waveform-lines" href="/it/sdk/stems">
    Avvia attività di separazione delle stem.
  </Card>

  <Card title="Lyrics sync" icon="closed-captioning" href="/it/sdk/lyrics-sync">
    Esegui di nuovo la sincronizzazione dei testi.
  </Card>

  <Card title="Exports" icon="file-video" href="/it/sdk/exports">
    Flussi di lavoro di esportazione nel cloud e in locale.
  </Card>

  <Card title="Tasks" icon="list-check" href="/it/sdk/tasks">
    Ispeziona le attività e attendi il completamento.
  </Card>

  <Card title="Presets" icon="palette" href="/it/sdk/presets">
    Configurazioni di rendering riutilizzabili.
  </Card>

  <Card title="Media" icon="image" href="/it/sdk/media">
    Carica sfondi, loghi e intro.
  </Card>

  <Card title="Project settings" icon="sliders" href="/it/sdk/project-settings">
    Impostazioni di rendering a livello di progetto.
  </Card>

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

## Cosa fare dopo

* [Quickstart](/it/sdk/quickstart) — il percorso più breve per un karaoke finito
* [API reference](/it/api) — ogni endpoint, generato automaticamente da OpenAPI
* [AI agents](/it/agents) — regole operative per gli autori di agenti