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

# Introduction

# Producer 音乐生成简介

欢迎使用 **Producer 音乐生成**服务文档！

Producer 是一项由 **Lyria 3 Pro**（Google DeepMind）驱动的 AI 音乐生成服务，支持通过文本提示、歌词甚至图片创作高质量音乐。

## 支持的模型

| 模型            | 描述                                  |
| ------------- | ----------------------------------- |
| `Lyria 3 Pro` | Google DeepMind 最新音乐生成模型 — 高质量，推荐使用 |

## 功能特性

<CardGroup cols={2}>
  <Card title="创作音乐" icon="music">
    通过音效提示和歌词生成原创曲目，精细控制音乐风格
  </Card>

  <Card title="图片引导" icon="image">
    使用图片影响生成音乐的氛围和风格
  </Card>

  <Card title="音轨分离" icon="sliders">
    将生成的曲目分离为独立音轨（人声、鼓、贝斯等）
  </Card>

  <Card title="多格式导出" icon="download">
    导出为 MP3、M4A、WAV 音频或生成带视觉预设的视频
  </Card>
</CardGroup>

## 如何使用 Producer

<Steps>
  <Step title="创建音乐生成任务">
    调用 `POST /producer/audios`，传入您的音效提示、歌词和模型。您将收到一个 `taskId`。
  </Step>

  <Step title="轮询获取结果">
    使用 `GET /producer/tasks?taskId=xxx` 轮询，直到状态变为 `completed`。结果中包含生成的音频数据。
  </Step>

  <Step title="下载或处理">
    使用 `/producer/download` 获取 MP3/M4A/WAV 音频，使用 `/producer/download-video` 获取带可视化效果的视频，或使用 `/producer/stems` 进行音轨分离。
  </Step>
</Steps>

## 快速示例

<CodeGroup>
  ```bash Create Music theme={null}
  curl -X POST "https://api.mountsea.ai/producer/audios" \
    -H "Authorization: Bearer your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "action": "create_music",
      "model": "Lyria 3 Pro",
      "soundPrompt": "emotional pop with gentle piano, warm synths, and a catchy beat",
      "lyrics": "[Verse]\nSunshine on my face today\nEverything is going my way\n\n[Chorus]\nSummer vibes, feeling alive",
      "title": "Summer Vibes",
      "makeInstrumental": false
    }'
  ```

  ```bash Poll Task Status theme={null}
  curl -X GET "https://api.mountsea.ai/producer/tasks?taskId=your-task-id" \
    -H "Authorization: Bearer your-api-key"
  ```
</CodeGroup>

## 可用端点

| 端点                         | 方法   | 描述                  |
| -------------------------- | ---- | ------------------- |
| `/producer/audios`         | POST | 使用 Lyria 3 Pro 创作音乐 |
| `/producer/tasks`          | GET  | 查询任务状态和结果           |
| `/producer/upload`         | POST | 上传外部音频文件            |
| `/producer/stems`          | POST | 获取音轨分离结果            |
| `/producer/download`       | POST | 下载音频（MP3/M4A/WAV）   |
| `/producer/download-video` | POST | 生成并下载视频             |

***

### 浏览 API 文档

* [创作音乐](audios) — 使用音效提示、歌词和图片生成音乐
* [获取任务状态](task) — 轮询任务状态和结果
* [上传音频](upload) — 上传外部音频进行处理
* [获取音轨分离](stems) — 将音频分离为独立音轨
* [下载音频](download) — 导出为 MP3/M4A/WAV
* [下载视频](download-video) — 生成带视觉预设的视频

## 关键参数

| 参数                 | 类型      | 描述                               |
| ------------------ | ------- | -------------------------------- |
| `action`           | string  | `create_music`（必填）               |
| `model`            | string  | `Lyria 3 Pro`（必填）                |
| `soundPrompt`      | string  | 音乐的风格/氛围描述                       |
| `lyrics`           | string  | 带有段落标签的歌词，如 `[Verse]`、`[Chorus]` |
| `title`            | string  | 歌曲标题（最多 80 个字符）                  |
| `seed`             | number  | 用于可重复生成的随机种子                     |
| `makeInstrumental` | boolean | 生成无人声的纯音乐（默认：false）              |
| `imageUrl`         | string  | 用于图片引导生成的图片 URL                  |

<Tip>
  音乐生成时需提供 `soundPrompt` 或 `lyrics` 其中之一。设置 `makeInstrumental: true` 可忽略歌词，生成纯器乐曲目。
</Tip>