Lyrics-Synchronisierung

Die Lyrics-Synchronisierung richtet den Liedtext am Audio aus, damit Wörter im richtigen Moment hervorgehoben werden. Verwende client.projects.syncLyrics(...), um die Synchronisierung für jedes Projekt erneut auszuführen – mit aktualisierten Lyrics, einem anderen Modell oder einer neuen Sprache.

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

Starte eine neue Lyrics-Synchronisierungsoperation.

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

Lyrics-Quelle

Übergebe ein lyricsSource-Objekt im Request-Body:

transcribe
align

Lass das Modell Lyrics aus dem Audio transkribieren.

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

Übergebe die exakten Lyrics. Das Modell richtet sie am Audio aus.

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

Sync-Modelle

Alignment-Modelle (verwende sie mit align, wenn du genaue Lyrics hast):

audioshake-alignment
musicai-alignment
musicai-alignment-subword

Transkriptionsmodelle (verwende sie mit transcribe):

audioshake-transcription
musicai-transcription
wav2vec2
whisper

Siehe Sync model reference für Hinweise.

End-to-End-Beispiel

import { YoukaClient } from "@youka/de/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");
}

Was kommt als Nächstes

Stems — Stem-Separation erneut ausführen, bevor du erneut synchronisierst
Tasks — Operation-Handles und Abbruchmuster
Sync model reference — das richtige Modell auswählen

Overview

How To

Customization

Audio

Settings

Exporting

Account

Lyrics-Synchronisierung

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

Lyrics-Quelle

Sync-Modelle

End-to-End-Beispiel

Was kommt als Nächstes

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

​Lyrics-Quelle

​Sync-Modelle

​End-to-End-Beispiel

​Was kommt als Nächstes

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

Lyrics-Quelle

Sync-Modelle

End-to-End-Beispiel

Was kommt als Nächstes