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

# Introduction to Producer Music Generation

Welcome to the **Producer Music Generation** service documentation!

Producer is an AI music generation service powered by **Lyria 3 Pro** (Google DeepMind), enabling high-quality music creation from text prompts, lyrics, and even images.

## Supported Models

| Model         | Description                                                                 |
| ------------- | --------------------------------------------------------------------------- |
| `Lyria 3 Pro` | Google DeepMind's latest music generation model — high quality, recommended |

## Features

<CardGroup cols={2}>
  <Card title="Create Music" icon="music">
    Generate original tracks from sound prompts and lyrics with fine-grained control over style
  </Card>

  <Card title="Image-Guided" icon="image">
    Use an image to influence the mood and style of generated music
  </Card>

  <Card title="Stem Separation" icon="sliders">
    Split generated tracks into individual stems (vocals, drums, bass, etc.)
  </Card>

  <Card title="Multi-Format Export" icon="download">
    Export as MP3, M4A, WAV audio or generate video with visual presets
  </Card>
</CardGroup>

## How to Use Producer

<Steps>
  <Step title="Create a music generation task">
    Call `POST /producer/audios` with your sound prompt, lyrics, and model. You'll receive a `taskId`.
  </Step>

  <Step title="Poll for results">
    Use `GET /producer/tasks?taskId=xxx` to poll until status is `completed`. The result contains the generated audio data.
  </Step>

  <Step title="Download or process">
    Use `/producer/download` to get audio in MP3/M4A/WAV, `/producer/download-video` for video with visualizers, or `/producer/stems` for stem separation.
  </Step>
</Steps>

## Quick Example

<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>

## Available Endpoints

| Endpoint                   | Method | Description                   |
| -------------------------- | ------ | ----------------------------- |
| `/producer/audios`         | POST   | Create music with Lyria 3 Pro |
| `/producer/tasks`          | GET    | Query task status and results |
| `/producer/upload`         | POST   | Upload external audio file    |
| `/producer/stems`          | POST   | Get stem separation           |
| `/producer/download`       | POST   | Download audio (MP3/M4A/WAV)  |
| `/producer/download-video` | POST   | Generate and download video   |

***

### Explore the API Documentation

* [Create Music](audios) — Generate music with sound prompts, lyrics, and images
* [Get Task Status](task) — Poll task status and results
* [Upload Audio](upload) — Upload external audio for processing
* [Get Stems](stems) — Separate audio into individual stems
* [Download Audio](download) — Export as MP3/M4A/WAV
* [Download Video](download-video) — Generate video with visual presets

## Key Parameters

| Parameter          | Type    | Description                                         |
| ------------------ | ------- | --------------------------------------------------- |
| `action`           | string  | `create_music` (required)                           |
| `model`            | string  | `Lyria 3 Pro` (required)                            |
| `soundPrompt`      | string  | Style/mood description for the music                |
| `lyrics`           | string  | Lyrics with section tags like `[Verse]`, `[Chorus]` |
| `title`            | string  | Song title (max 80 characters)                      |
| `seed`             | number  | Random seed for reproducible generation             |
| `makeInstrumental` | boolean | Generate without vocals (default: false)            |
| `imageUrl`         | string  | Image URL for image-guided generation               |

<Tip>
  Either `soundPrompt` or `lyrics` should be provided for music generation. Set `makeInstrumental: true` to ignore lyrics and generate an instrumental track.
</Tip>