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

# Music Generation

> Compose original music from a text prompt describing genre, mood, instruments, and tempo.

Music generation creates original compositions from a text description. Describe the genre, mood, instruments, and tempo and the agent produces an audio file.

## How to generate music

<Steps>
  <Step title="Describe the music you want">
    Type a prompt describing the style, mood, and characteristics of the music.

    <Prompt description="Lo-fi background music.">
      Generate a 30-second lo-fi hip hop beat with mellow piano, soft drums, and a rainy mood. Good for a study playlist.
    </Prompt>

    <Prompt description="Upbeat corporate jingle.">
      Compose a 15-second upbeat corporate jingle. Clean guitar, light percussion, positive energy. For a product demo video.
    </Prompt>

    <Prompt description="Cinematic orchestral score.">
      Create a 60-second cinematic orchestral piece. Build from quiet strings to a full brass crescendo. Epic and dramatic.
    </Prompt>
  </Step>

  <Step title="Set the duration (optional)">
    Mention the duration in your prompt. If you do not, the agent chooses a reasonable length.

    | Duration range           | Notes   |
    | ------------------------ | ------- |
    | 3 seconds                | Minimum |
    | 600 seconds (10 minutes) | Maximum |
  </Step>

  <Step title="Review and download">
    The music file appears in the chat with a waveform player. Listen to it and download as MP3.
  </Step>
</Steps>

<Tip>
  Be specific about instruments, tempo, and mood. "Ambient electronic with soft pads and a slow tempo" produces better results than "some chill music."
</Tip>

## What you cannot do

* You cannot generate music longer than 10 minutes in a single request.
* You cannot add lyrics to generated music. Music generation is instrumental only.
* You cannot layer music over speech in a single operation. Generate them separately and combine in an external editor.
* You cannot edit or remix a generated track. Generate a new version with an updated prompt.

## Next steps

<CardGroup cols={2}>
  <Card title="Sound Effects" icon="waveform" href="/sound-effects">
    Generate short sound effects from a text description.
  </Card>

  <Card title="Text-to-Speech" icon="microphone" href="/text-to-speech">
    Generate speech to pair with your background music.
  </Card>
</CardGroup>