Sincronizzazione testi

Lyrics sync allinea il testo dei lyrics 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 corpo della richiesta:

transcribe
align

Lascia che il modello trascriva i testi dall’audio.

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

Passa 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 sincronizzazione

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 — esegui di nuovo la separazione degli stem prima di risincronizzare
Tasks — handle delle operazioni e pattern di annullamento
Choose a lyrics sync model — scegli il modello giusto

Scopri i modelli supportati

client.capabilities.get() restituisce il supporto ai modelli configurati e l’idoneità dell’account autenticato. Ogni modello descrive la sua operazione, inputAudio, i workflows supportati, la policy sulle lingue, le feature richieste e suppliedTextHandling. La disponibilità non è una garanzia di uptime del provider. La trascrizione accetta lyrics opzionali come testo di riferimento. La risposta delle capability distingue i keyterm del provider dalle correzioni dopo la trascrizione. Il testo di riferimento non garantisce un output identico. Per un testo fornito esatto, scegli un modello di allineamento idoneo.

Modifica delle tempistiche esistenti

Usa client.projects.alignments.list(projectId) e .get(projectId, alignmentId) per leggere risorse di timing tipizzate. .update(projectId, alignmentId, body) sostituisce le tempistiche senza un job di sincronizzazione né un blocco di credito di elaborazione. Il body di update richiede l’alignment completo e expectedRevision. Aggiungi select: true e expectedSelectionRevision per selezionare l’allineamento salvato in modo atomico. .select(projectId, alignmentId, { expectedRevision, expectedSelectionRevision }) seleziona tempistiche esistenti. Entrambe le revisioni proteggono da modifiche concorrenti. Una revisione obsoleta restituisce HTTP 409. Mantieni gli ID degli item, il testo, gli indici, i cantanti e le traduzioni durante la modifica. I tempi sono in secondi assoluti. Ogni fine deve essere maggiore del suo inizio. Tempistiche non valide, negative o fuori durata vengono rifiutate. Sono supportate sovrapposizioni legittime e tempistiche da duetto. Vedi Automate lyric videos per una modifica completa delle tempistiche e la gestione dei conflitti.

Overview

How To

Customization

Audio

Settings

Exporting

Account

Sincronizzazione testi

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

Sorgente dei testi

Modelli di sincronizzazione

Esempio end-to-end

Cosa fare dopo

Scopri i modelli supportati

Modifica delle tempistiche esistenti

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

​Sorgente dei testi

​Modelli di sincronizzazione

​Esempio end-to-end

​Cosa fare dopo

​Scopri i modelli supportati

​Modifica delle tempistiche esistenti

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

Sorgente dei testi

Modelli di sincronizzazione

Esempio end-to-end

Cosa fare dopo

Scopri i modelli supportati

Modifica delle tempistiche esistenti