Sincronización de letras

La sincronización de letras alinea el texto de la letra con el audio para que las palabras se resalten en el momento correcto. Usa client.projects.syncLyrics(...) para volver a ejecutar la sincronización en cualquier proyecto con letras actualizadas, un modelo diferente o un nuevo idioma.

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

Inicia una nueva operación de sincronización de letras.

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

Fuente de letras

Pasa un objeto lyricsSource en el cuerpo de la solicitud:

transcribe
align

Deja que el modelo transcriba las letras a partir del audio.

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

Pasa las letras exactas. El modelo las alinea con el audio.

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

Modelos de sincronización

Modelos de alineación (úsalos con align cuando tengas letras precisas):

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

Modelos de transcripción (úsalos con transcribe):

audioshake-transcription
elevenlabs-transcription
musicai-transcription
whisper

Consulta Choose a lyrics sync model para obtener orientación.

Ejemplo de extremo a extremo

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

Qué sigue

Stems — vuelve a ejecutar la separación de stems antes de volver a sincronizar
Tasks — identificadores de operación y patrones de cancelación
Choose a lyrics sync model — elige el modelo adecuado

Overview

How To

Customization

Audio

Settings

Exporting

Account

Sincronización de letras

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

Fuente de letras

Modelos de sincronización

Ejemplo de extremo a extremo

Qué sigue

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

​Fuente de letras

​Modelos de sincronización

​Ejemplo de extremo a extremo

​Qué sigue

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

Fuente de letras

Modelos de sincronización

Ejemplo de extremo a extremo

Qué sigue