Vai al contenuto principale
@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

npm install @youka/sdk

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

​
Esempio rapido

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

Quickstart

Esempio end-to-end: crea, attendi, esporta, scarica.

Authentication

Configura YoukaClient e gestisci le chiavi API in sicurezza.

Account, credits, and billing

Helper per identità, saldo, prezzi, checkout e portale di fatturazione.

Projects

Caricamenti, creazione, elenco ed eliminazione.

Stems

Avvia attività di separazione delle stem.

Lyrics sync

Esegui di nuovo la sincronizzazione dei testi.

Exports

Flussi di lavoro di esportazione nel cloud e in locale.

Tasks

Ispeziona le attività e attendi il completamento.

Presets

Configurazioni di rendering riutilizzabili.

Media

Carica sfondi, loghi e intro.

Project settings

Impostazioni di rendering a livello di progetto.

Errors

YoukaRequestError e YoukaTaskError.

​
Cosa fare dopo

  • Quickstart — il percorso più breve per un karaoke finito
  • API reference — ogni endpoint, generato automaticamente da OpenAPI
  • AI agents — regole operative per gli autori di agenti