Questa guida illustra il percorso più veloce da un file audio grezzo a un video karaoke renderizzato usando @youka/sdk.
Prima di iniziare
- Node.js 20 o versioni successive
- Una chiave API Youka in
YOUKA_API_KEY (creane una su online.youka.io/account nella sezione API keys)
- Un file audio locale (
./song.mp3) oppure un URL remoto
Installazione
Crea, attendi, esporta
client.projects.create() gestisce i caricamenti per le sorgenti path, bytes e url.
Per un controllo del caricamento a più basso livello, usa client.uploads.*.
Tre tipi di sorgente
File locale
Byte in memoria
URL remoto
Cosa fare dopo
- Projects — API completa dei progetti
- Exports — render locale e
client.exports.prepareLocal
- Errors — gestire
YoukaRequestError e YoukaTaskError
- AI agents — pattern consigliati per polling e retry