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

# SDK de Node.js

> Automatiza Youka desde Node.js y Bun con el SDK oficial de TypeScript

`@youka/sdk` es el SDK oficial de TypeScript para la API de Youka. Úsalo para crear karaoke a partir de audio o video, personalizar letras y estilo, exportar videos MP4 e integrar flujos de trabajo de Youka en aplicaciones de Node.js o Bun.

## Instalación

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

## Requisitos

* Node.js 20 o posterior, o Bun 1.1+
* Una clave de API de Youka en `YOUKA_API_KEY` (crea una en [online.youka.io/account](https://online.youka.io/account) en **API keys**)

## Ejemplo rápido

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

## Referencia

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/es/sdk/quickstart">
    Ejemplo de principio a fin: crear, esperar, exportar, descargar.
  </Card>

  <Card title="Authentication" icon="key" href="/es/sdk/authentication">
    Configura `YoukaClient` y gestiona las claves de API de forma segura.
  </Card>

  <Card title="Account, credits, and billing" icon="credit-card" href="/es/sdk/account-billing">
    Identidad, saldo, precios, pago y utilidades del portal de facturación.
  </Card>

  <Card title="Projects" icon="folder" href="/es/sdk/projects">
    Cargas, creación, listado y eliminación.
  </Card>

  <Card title="Stems" icon="waveform-lines" href="/es/sdk/stems">
    Inicia tareas de separación de stems.
  </Card>

  <Card title="Lyrics sync" icon="closed-captioning" href="/es/sdk/lyrics-sync">
    Vuelve a ejecutar la sincronización de letras.
  </Card>

  <Card title="Exports" icon="file-video" href="/es/sdk/exports">
    Flujos de trabajo de exportación en la nube y en local.
  </Card>

  <Card title="Tasks" icon="list-check" href="/es/sdk/tasks">
    Inspecciona tareas y espera a que finalicen.
  </Card>

  <Card title="Presets" icon="palette" href="/es/sdk/presets">
    Configuraciones de render reutilizables.
  </Card>

  <Card title="Media" icon="image" href="/es/sdk/media">
    Sube fondos, logos e intros.
  </Card>

  <Card title="Project settings" icon="sliders" href="/es/sdk/project-settings">
    Ajustes de render a nivel de proyecto.
  </Card>

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

## Qué sigue

* [Quickstart](/es/sdk/quickstart) — la forma más rápida de llegar a un karaoke terminado
* [API reference](/es/api) — todos los endpoints, generados automáticamente a partir de OpenAPI
* [AI agents](/es/agents) — reglas operativas para autores de agentes