Lyrics sync

Lyrics sync allinea il testo dei testi all’audio in modo che le parole si evidenzino nel momento giusto. Usa client.projects.syncLyrics(...) per rieseguire la sincronizzazione su qualsiasi progetto con testi aggiornati, un modello diverso o una nuova lingua.

`client.projects.syncLyrics(projectId, body, options?)`

Avvia una nuova operazione di sincronizzazione dei testi.

const operation = await client.projects.syncLyrics("prj_abc123", {
  lyricsSource: {
    type: "align",
    lyrics: "First line\nSecond line\n...",
    syncModel: "audioshake-alignment",
  },
});

const { project } = await client.projects.wait(operation);
console.log(project.alignments);

Sorgente dei testi

Passa un oggetto lyricsSource nel body della richiesta:

transcribe
align

Lascia che il modello trascriva i testi dall’audio.

{
  lyricsSource: {
    type: "transcribe",
    syncModel: "audioshake-transcription",
    language: "en",
  },
}

Fornisci i testi esatti. Il modello li allinea all’audio.

{
  lyricsSource: {
    type: "align",
    lyrics: "First line\nSecond line\n...",
    syncModel: "audioshake-alignment",
    language: "en",
  },
}

Modelli di sync

Modelli di allineamento (usa con align quando hai testi accurati):

audioshake-alignment
musicai-alignment
musicai-alignment-subword
wav2vec2

Modelli di trascrizione (usa con transcribe):

audioshake-transcription
elevenlabs-transcription
musicai-transcription
whisper

Vedi Choose a lyrics sync model per indicazioni.

Esempio end-to-end

import { YoukaClient } from "@youka/sdk";
import { readFile } from "node:fs/promises";

const client = new YoukaClient({ apiKey: process.env.YOUKA_API_KEY! });

async function reAlignLyrics(projectId: string) {
  const lyrics = await readFile("./lyrics.txt", "utf8");

  const operation = await client.projects.syncLyrics(projectId, {
    lyricsSource: {
      type: "align",
      lyrics,
      syncModel: "audioshake-alignment",
      language: "en",
    },
  });

  const { project } = await client.projects.wait(operation);
  console.log("Updated lyrics with", project.lyrics?.length, "lines");
}

Cosa fare dopo

Stems — riesegui la separazione degli stem prima di risincronizzare
Tasks — handle delle operazioni e pattern di annullamento
Choose a lyrics sync model — scegli il modello giusto

Overview

How To

Customization

Audio

Settings

Exporting

Account

`client.projects.syncLyrics(projectId, body, options?)`

Sorgente dei testi

Modelli di sync

Esempio end-to-end

Cosa fare dopo

​client.projects.syncLyrics(projectId, body, options?)

​Sorgente dei testi

​Modelli di sync

​Esempio end-to-end

​Cosa fare dopo

`client.projects.syncLyrics(projectId, body, options?)`

Sorgente dei testi

Modelli di sync

Esempio end-to-end

Cosa fare dopo