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

# Анализ и экспорт

> midi транскрибация, bpm анализ, alignedLyrics тайминг, download/wav, generateMp4

```
POST https://toapis.com/v1/music/generations/{operation}
```

<ParamField body="model" type="string" required>Фиксированное `"suno"`</ParamField>
<ParamField body="task_id" type="string" required>ID исходной задачи</ParamField>
<ParamField body="audio_index" type="number">Номер трека</ParamField>

## midi — транскрибация в MIDI(\$0.05)

Преобразует трек в нотные данные по инструментам — `result.instruments[]`:

<ResponseField name="instruments" type="array">
  <Expandable title="Дорожка инструмента">
    <ResponseField name="name" type="string">Имя, например `Electric Piano 1`</ResponseField>
    <ResponseField name="program" type="integer">Номер программы General MIDI</ResponseField>
    <ResponseField name="is_drum" type="boolean">Ударная дорожка(pitch — номер ударного)</ResponseField>

    <ResponseField name="notes" type="array">
      Ноты:`start`/`end`(сек), `pitch`(0-127), `velocity`(0-1)
    </ResponseField>
  </Expandable>
</ResponseField>

## bpm — анализ BPM(\$0.0008)

Возвращает `avg_bpm` / `max_bpm` / `min_bpm` в `result`.

## alignedLyrics — тайминг текста(\$0.0008)

Возвращает выравнивание текста по строкам/словам.

## download — мультиформат(\$0.0016)

<ParamField body="formats" type="array">Форматы:`mp3` / `m4a` / `wav`</ParamField>
<ParamField body="format" type="string">Один формат(укажите `formats` или `format`)</ParamField>

Возвращает `result.files[]`; файлы зеркалятся на CDN.

## generateMp4 — видео с текстом(\$0.004)

Генерирует MP4 с субтитрами текста; `result.videoUrl`(CDN).

## wav — выгрузка WAV(\$0.0016, устар.)

<Tip>Устарело — используйте `download` с `format: "wav"`.</Tip>

## Response

<ResponseField name="task_id" type="string">ID задачи</ResponseField>
<ResponseField name="status" type="string">`submitted`</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.