> ## 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 视频

> [!NOTE]
>
> **国内用户请注意：** 中国大陆用户请使用 `https://toapis.cn` 作为接口地址（Base URL）。

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

**model** `string` *required*

固定 `"suno"`

**task\_id** `string` *required*

源任务 ID

**audio\_index** `number`

源曲目序号

## midi — MIDI 转谱(\$0.05)

将歌曲转为分轨 MIDI 音符数据。`result.instruments[]` 返回每轨乐器：

**instruments** `array`

**乐器轨**

**name** `string`

乐器名，如 `Electric Piano 1`

**program** `integer`

General MIDI 音色号

**is\_drum** `boolean`

是否打击轨（打击轨的 pitch 为鼓件编号）

**notes** `array`

音符列表：`start`/`end`(秒）、`pitch`(MIDI 音高 0-127)、`velocity`(0-1 力度）

## bpm — BPM 分析(\$0.0008)

返回 `result` 中的 `avg_bpm` / `max_bpm` / `min_bpm`。

## alignedLyrics — 歌词时间轴(\$0.0008)

返回逐句/逐词的时间轴对齐数据。

## download — 多格式下载(\$0.0016)

**formats** `array`

格式列表：`mp3` / `m4a` / `wav`

**format** `string`

单格式（与 `formats` 二选一，至少给一个）

返回 `result.files[]`，文件已镜像本站 CDN。

## generateMp4 — 歌词视频(\$0.004)

生成带歌词字幕的 MP4，返回 `result.videoUrl`（已镜像 CDN)。

## wav — 下载 WAV(\$0.0016，旧版）

> [!TIP]
>
> 已废弃，建议使用 `download` 并指定 `format: "wav"`。

## Response

**task\_id** `string`

任务 ID

**status** `string`

`submitted`


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