> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Стемы

> Запуск задач разделения на стемы для существующего проекта

Стемы — это вокальные и инструментальные дорожки, извлечённые из исходного аудио. Youka автоматически разделяет на стемы при создании проекта, но при необходимости вы можете повторно запустить разделение с другой моделью.

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

Запускает новую операцию разделения на стемы для проекта.

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

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

### Parameters

<ParamField path="projectId" type="string" required>
  Проект для повторной обработки.
</ParamField>

<ParamField path="splitModel" type="SplitModel">
  Модель разделения на стемы. См. [Справочник по моделям разделения](/ru/desktop/split-model)
  для рекомендаций.
</ParamField>

### Available models

| Value                                         | Description                               |
| --------------------------------------------- | ----------------------------------------- |
| `mdx23c`                                      | По умолчанию. Баланс качества и скорости. |
| `audioshakeai`                                | Высококачественное разделение AudioShake. |
| `audioshake_vocals_lead`                      | Только вокал и лид-вокал.                 |
| `musicai_instrumental_only`                   | Выход только инструментал.                |
| `musicai_lead_backing_other`                  | Лид, бэк-вокал и другие стемы.            |
| `musicai_with_backing_vocals`                 | Вокал, включая бэк-дорожки.               |
| `musicai_without_backing_vocals`              | Только лид-вокал.                         |
| `uvr_mdxnet_kara_2`                           | UVR-модель, настроенная под караоке.      |
| `bs_roformer`                                 | Модель BS-Roformer.                       |
| `mel_band_roformer_instrumental_becruily`     | Инструментал Roformer (mel-band).         |
| `mel_band_roformer_instrumental_instv7_gabox` | Альтернативный инструментал mel-band.     |
| `demucs`                                      | Facebook Demucs.                          |

## End-to-end example

```ts theme={null}
import { YoukaClient, YoukaTaskError } from "@youka/ru/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;
  }
}
```

<Tip>
  Используйте `client.tasks.get(taskId)` или `client.tasks.wait(taskId)` только когда вам
  явно нужен низкоуровневый доступ к задачам. В большинстве случаев следует оставаться на
  `client.projects.wait(operation)`.
</Tip>

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

Скачайте один стем без конвертации в другой формат. Выберите ровно один
стем по ID или по типу:

```ts theme={null}
await client.projects.downloadStem(
  "prj_abc123",
  { type: "instrumental" },
  { output: "./stems" },
);

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

Поддерживаемые типы: `original`, `instrumental`, `vocals` и
`backing_vocals`.

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

Скачайте несколько стемов. Передайте `types`, передайте `stemIds` или не указывайте selector,
чтобы скачать все доступные стемы:

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

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

Для скачивания нескольких стемов используйте выходную директорию. SDK записывает исходные
сохранённые файлы стемов и не выполняет транскодирование.

## What's next

* [Синхронизация текста](/ru/sdk/lyrics-sync) — повторная синхронизация текста после замены стемов
* [Задачи](/ru/sdk/tasks) — хэндлы операций и продвинутый опрос задач
* [Справочник по моделям разделения](/ru/desktop/split-model) — выберите подходящую модель