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

# MusicMint API

> 面向开发者的企业级 AI 音乐生成 API

## 欢迎使用 MusicMint

MusicMint 提供统一的 REST API，让你轻松生成专业品质的音乐、歌词、音频分轨等内容——底层集成多个顶级 AI 音乐模型，自动路由与容灾切换。

无论你在打造音乐 App、内容创作工具，还是实现大规模音频自动化生产，MusicMint 都帮你屏蔽底层复杂性，让你专注于产品本身。

<CardGroup cols={2}>
  <Card title="快速上手" icon="rocket" href="/zh/quickstart">
    5 分钟内生成你的第一首曲目。
  </Card>

  <Card title="API 参考" icon="code" href="/zh/api-reference/introduction">
    探索所有接口、参数和响应格式。
  </Card>

  <Card title="身份认证" icon="key" href="/zh/api-reference/appkey">
    创建并管理你的 AppKey。
  </Card>

  <Card title="Webhook 回调" icon="webhook" href="/zh/api-reference/webhooks">
    任务完成时主动推送结果。
  </Card>
</CardGroup>

## 核心能力

### 音乐生成

通过文字描述或风格标签创作原创完整曲目。你可以指定情绪、曲风、乐器，也可以直接粘贴自定义歌词。MusicMint 自动选择最优模型，返回可直接播放的 MP3 文件。

### 翻唱与混音

用新曲风、新调性或新歌词改编已有片段。Remaster 接口可对音频进行清理和重处理，保留原有作曲结构。

### 人声工具

* **添加人声** — 在纯音乐上叠加 AI 生成的人声演唱
* **添加伴奏** — 为上传的人声录音自动配上 AI 器乐伴奏
* **哼唱生成** — 哼出旋律并上传，AI 据此生成完整编曲作品

### 歌词生成

根据主题或描述用大语言模型创作歌词，返回结构化的主歌、副歌、桥段，可直接用于生成请求。

### 音频处理

* **人声分离** — 将曲目拆分为人声、鼓、低音及其他轨道
* **MIDI 导出** — 从任意音频片段中提取 MIDI 表示
* **波形 / WAV** — 获取原始波形数据或无损音频
* **歌词时间轴** — 逐词时间戳，用于卡拉 OK 或字幕同步

### AI 歌手（Persona）

从短音频样本训练自定义 AI 声音模型。创建完成后，该音色可演唱任意歌词，保持一致且辨识度高的声线。

## 工作原理

所有生成接口均为**异步**。你提交请求后获得 `task_id`，随后通过轮询 `GET /api/v1/task/{id}` 或配置 Webhook 回调获取结果。大多数曲目可在 30–120 秒内完成。

少数工具类接口（音频上传、Concat 拼接）为**同步**，直接返回结果。

## 稳定性与规模

* **多模型路由** — 请求在多个服务商之间分发，自动故障切换
* **优先级队列** — 你的 API 等级决定队列优先级，Pro 密钥跳过免费队列
* **TTL 托管存储** — 生成文件托管在 CDN，支持自定义保留时长（默认 7 天）
* **签名 Webhook** — 每条回调均附带 HMAC-SHA256 签名，确保来源可验证

## 频率限制与配额

限流按 AppKey 维度配置，可在控制台查看当前配额。如需提升生产环境限额，请联系技术支持。