Stems

Stems são as faixas vocais e instrumentais extraídas do áudio de origem. O Youka separa stems automaticamente quando você cria um projeto, mas você pode executar a separação novamente com um modelo diferente sempre que precisar.

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

Inicie uma nova operação de separação de stems para um projeto.

const operation = await client.projects.separateStems("prj_abc123", {
  splitModel: "audioshakeai",
});

const { project } = await client.projects.wait(operation);
console.log(project.stems);

Parameters

string

required

O projeto a ser reprocessado.

SplitModel

Modelo de separação de stems. Veja Referência de modelo de separação para orientação.

Modelos disponíveis

Value	Description
`mdx23c`	Padrão. Qualidade e velocidade equilibradas.
`audioshakeai`	Separação AudioShake de alta qualidade.
`audioshake_vocals_lead`	Apenas vocais e vocais principais.
`musicai_instrumental_only`	Saída apenas instrumental.
`musicai_lead_backing_other`	Principal, backing vocals e outros stems.
`musicai_with_backing_vocals`	Vocais incluindo faixas de apoio.
`musicai_without_backing_vocals`	Apenas vocais principais.
`uvr_mdxnet_kara_2`	Modelo UVR ajustado para karaokê.
`bs_roformer`	Modelo BS-Roformer.
`mel_band_roformer_instrumental_becruily`	Roformer mel-band instrumental.
`mel_band_roformer_instrumental_instv7_gabox`	Instrumental mel-band alternativo.
`demucs`	Facebook Demucs.

Exemplo de ponta a ponta

import { YoukaClient, YoukaTaskError } from "@youka/pt/sdk";

const client = new YoukaClient({ apiKey: process.env.YOUKA_API_KEY! });

async function reRunStems(projectId: string) {
  const operation = await client.projects.separateStems(projectId, {
    splitModel: "audioshakeai",
  });

  try {
    const { project } = await client.projects.wait(operation);
    console.log("New stems:", project.stems);
  } catch (error) {
    if (error instanceof YoukaTaskError) {
      console.error("Stem separation failed:", error.code, error.message);
      throw error;
    }
    throw error;
  }
}

Use client.tasks.get(taskId) ou client.tasks.wait(taskId) apenas quando você precisar explicitamente de acesso de baixo nível a tarefas. A maioria dos usuários deve ficar em client.projects.wait(operation).

`client.projects.downloadStem(projectId, selector, options?)`

Baixe um stem sem convertê-lo para outro formato. Selecione exatamente um stem por ID ou tipo:

await client.projects.downloadStem(
  "prj_abc123",
  { type: "instrumental" },
  { output: "./stems" },
);

await client.projects.downloadStem(
  "prj_abc123",
  { stemId: "stm_abc123" },
  { output: "./stems/original.wav" },
);

Os tipos compatíveis são original, instrumental, vocals e backing_vocals.

`client.projects.downloadStems(projectId, selector?, options?)`

Baixe vários stems. Passe types, passe stemIds ou omita o seletor para baixar todos os stems disponíveis:

await client.projects.downloadStems(
  "prj_abc123",
  { types: ["original", "instrumental", "vocals"] },
  { output: "./stems" },
);

await client.projects.downloadStems("prj_abc123", undefined, {
  output: "./stems",
});

Para downloads com múltiplos stems, use um diretório de saída. O SDK grava os arquivos de stems originais armazenados e não os transcodifica.

Próximos passos

Sincronização de letras — ressincronize letras após trocar stems
Tarefas — handles de operação e polling avançado de tarefas
Referência de modelo de separação — escolha o modelo certo

Overview

How To

Customization

Audio

Settings

Exporting

Account

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

Parameters

Modelos disponíveis

Exemplo de ponta a ponta

`client.projects.downloadStem(projectId, selector, options?)`

`client.projects.downloadStems(projectId, selector?, options?)`

Próximos passos

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

​Parameters

​Modelos disponíveis

​Exemplo de ponta a ponta

​client.projects.downloadStem(projectId, selector, options?)

​client.projects.downloadStems(projectId, selector?, options?)

​Próximos passos

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

Parameters

Modelos disponíveis

Exemplo de ponta a ponta

`client.projects.downloadStem(projectId, selector, options?)`

`client.projects.downloadStems(projectId, selector?, options?)`

Próximos passos