Skip to main content
La synchronisation des paroles aligne le texte des paroles sur l’audio afin que les mots soient surlignés au bon moment. Utilisez client.projects.syncLyrics(...) pour relancer la synchronisation sur n’importe quel projet avec des paroles mises à jour, un modèle différent ou une nouvelle langue.

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

Démarrez une nouvelle opération de synchronisation des paroles. 
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);

​
Source des paroles

Passez un objet lyricsSource dans le corps de la requête :
Laissez le modèle transcrire les paroles à partir de l’audio.
{
  lyricsSource: {
    type: "transcribe",
    syncModel: "audioshake-transcription",
    language: "en",
  },
}

​
Modèles de synchronisation

Modèles d’alignement (à utiliser avec align lorsque vous avez des paroles exactes) :
  • audioshake-alignment
  • musicai-alignment
  • musicai-alignment-subword
Modèles de transcription (à utiliser avec transcribe) :
  • audioshake-transcription
  • musicai-transcription
  • wav2vec2
  • whisper
Consultez la page Sync model reference pour des recommandations.

​
Exemple de bout en bout

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");
}

​
Et ensuite

  • Stems — relancer la séparation des stems avant de resynchroniser
  • Tasks — handles d’opération et schémas d’annulation
  • Sync model reference — choisir le bon modèle