Saltar al contenido principal
@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

npm install @youka/sdk

​
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 en API keys)

​
Ejemplo rápido

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

Quickstart

Ejemplo de principio a fin: crear, esperar, exportar, descargar.

Authentication

Configura YoukaClient y gestiona las claves de API de forma segura.

Account, credits, and billing

Identidad, saldo, precios, pago y utilidades del portal de facturación.

Projects

Cargas, creación, listado y eliminación.

Stems

Inicia tareas de separación de stems.

Lyrics sync

Vuelve a ejecutar la sincronización de letras.

Exports

Flujos de trabajo de exportación en la nube y en local.

Tasks

Inspecciona tareas y espera a que finalicen.

Presets

Configuraciones de render reutilizables.

Media

Sube fondos, logos e intros.

Project settings

Ajustes de render a nivel de proyecto.

Errors

YoukaRequestError y YoukaTaskError.

​
Qué sigue

  • Quickstart — la forma más rápida de llegar a un karaoke terminado
  • API reference — todos los endpoints, generados automáticamente a partir de OpenAPI
  • AI agents — reglas operativas para autores de agentes