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

# Ace Step Musicgen

> Generate music from text prompt using Ace Step model.

## Overview

Generate music from text prompt using Ace Step model.

* **Output Type**: audio
* **Base Model**: musicgen
* **Estimated Cost**: 0.2 \* duration \* (number\_of\_steps/60) credits
* **Handler**: replicate

## Parameters

### Required Parameters

<ParamField body="tags" type="string" required>
  Text prompts to guide music generation (e.g., genre, mood, instruments, BPM). Supports tags, descriptions, and scenes. Use commas to separate different tags. E.g., 'synth-pop, electronic, pop, synthesizer, drums, bass, piano, 128 BPM, energetic, uplifting, modern'

  * Label: Tags (Prompt)
</ParamField>

### Optional Parameters

<ParamField body="lyrics" type="string" default="[inst]">
  Optional lyrics for the music. Can be multi-line. Use \[verse], \[chorus], and \[bridge] to separate different parts of the lyrics. Use \[instrumental] or \[inst] to generate instrumental music.

  * Label: Lyrics
</ParamField>

<ParamField body="duration" type="integer" default={30}>
  Desired duration of the generated audio in seconds.

  * Label: Duration
  * Minimum: 1
  * Maximum: 240
</ParamField>

<ParamField body="seed" type="integer" default="random">
  Seed for the generation. Set for reproducibility. If blank, a random value will be used.

  * Label: Seed
  * Minimum: 0
  * Maximum: 2147483647
</ParamField>

<ParamField body="number_of_steps" type="integer" default={60}>
  Number of inference steps. (More can improve quality but will increase cost/latency.)

  * Label: Number Of Steps
  * Minimum: 10
  * Maximum: 200
</ParamField>

<ParamField body="granularity_scale" type="float" default={10.0}>
  Omega scale for APG guidance (granularity scale), or similar for other CFG types. Higher values can reduce artifacts.

  * Label: Granularity Scale
  * Minimum: -100.0
  * Maximum: 100.0
</ParamField>

<ParamField body="guidance_interval" type="float" default={0.5}>
  Guidance interval.

  * Label: Guidance Interval
  * Minimum: 0.0
  * Maximum: 1.0
</ParamField>

<ParamField body="guidance_interval_decay" type="float" default={0.0}>
  Guidance interval decay.

  * Label: Guidance Interval Decay
  * Minimum: 0.0
  * Maximum: 1.0
</ParamField>

<ParamField body="guidance_scale" type="float" default={15.0}>
  Overall guidance scale. Controls how much the generation adheres to the prompt. Note that when lyric\_guidance\_scale > 1 and tag\_guidance\_scale > 1, this global guidance scale might not be applied.

  * Label: Guidance Scale
  * Minimum: 0.0
  * Maximum: 30.0
</ParamField>

<ParamField body="min_guidance_scale" type="float" default={3.0}>
  Minimum guidance scale.

  * Label: Min Guidance Scale
  * Minimum: 0.0
  * Maximum: 100.0
</ParamField>

<ParamField body="tag_guidance_scale" type="float" default={0.0}>
  Guidance scale for tags (text prompt). This is the specific guidance scale for the text component and typically applies to CFG. A suggested starting point could be around 5.0 (especially if lyric guidance is around 1.5).

  * Label: Tag Guidance Scale
  * Minimum: 0.0
  * Maximum: 10.0
</ParamField>

<ParamField body="lyric_guidance_scale" type="float" default={0.0}>
  Specific guidance scale for the lyric component.

  * Label: Lyric Guidance Scale
  * Minimum: 0.0
  * Maximum: 10.0
</ParamField>
