Синхронизация текста

Синхронизация текста выравнивает слова песни по аудио, чтобы слова подсвечивались в нужный момент. Используйте client.projects.syncLyrics(...), чтобы повторно запустить синхронизацию для любого проекта с обновлённым текстом, другой моделью или новым языком.

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

Запустите новую операцию синхронизации текста.

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

Источник текста

Передайте объект lyricsSource в теле запроса:

transcribe
align

Позвольте модели транскрибировать текст из аудио.

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

Передайте точный текст. Модель выровняет его по аудио.

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

Модели синхронизации

Модели выравнивания (используйте с align, когда у вас есть точный текст):

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

Модели транскрипции (используйте с transcribe):

audioshake-transcription
elevenlabs-transcription
musicai-transcription
whisper

Рекомендации см. в разделе Choose a lyrics sync model.

Сквозной пример

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

Что дальше

Stems — повторно запустите разделение на стемы перед повторной синхронизацией
Tasks — дескрипторы операций и шаблоны отмены
Choose a lyrics sync model — выберите подходящую модель

Overview

How To

Customization

Audio

Settings

Exporting

Account

Синхронизация текста

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

Источник текста

Модели синхронизации

Сквозной пример

Что дальше

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

​Источник текста

​Модели синхронизации

​Сквозной пример

​Что дальше

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

Источник текста

Модели синхронизации

Сквозной пример

Что дальше