# AI music generation
Source: https://docs.aden.space/docs/help/more/ai-music-generation

Generate a track from a description on /app/tracks/generate, or an AI audio reply from a version comment. Lyria 3 Pro and Clip through OpenRouter, priced per generation. Admin preview billed to Aden's OpenRouter balance until the Polar meter takes over. Every generated track carries `ai` + `ai:<model>` tags.
{/* Generated by `bun docs:publish` from docs/features/ai-music-generation.md: edit the spec, not this file. */}

## What it is [#what-it-is]

Describe a piece of music and a model plays it for you. On the generate page
the result becomes a new track in your team, with the audio as its first
version. In a version's comments the result comes back as a reply with the
audio attached, so you can ask for "a brighter synth line for the bridge"
right where the conversation about the bridge is happening.

Each generation is priced per song or per clip. The price is on the button
before you click it. While the feature is in admin preview, Aden carries the
cost.

## Using it [#using-it]

### On the generate page [#on-the-generate-page]

1. Open **Generate** from the create-track page header (admins only for
   now), or go to `/app/tracks/generate`.
2. Describe the music. Genre, mood, instruments and tempo all help.
3. Write lyrics, leave the box empty for the model to write its own, or turn
   on **Instrumental**.
4. Give it a title if you have one, pick a model, click **Generate**.
5. A minute or two later the track shows up in the list on the right, with a
   play button and a link to its page. It is a normal track: status *idea*,
   tags `ai` and `ai:<model>`, the prompt as its description.

### In a version's comments [#in-a-versions-comments]

* **From your draft.** Type what you want in the comment box and click the
  sparkles button next to **Comment** (or next to **Reply** in a thread). Pick
  a model and generate. The draft is the prompt; the audio arrives as an AI
  reply in the thread.
* **From someone's comment.** Hover a comment and click its sparkles action.
  That comment's text is the prompt, and the reply lands under it, pinned to
  the same timestamp when the comment had one.

An AI reply shows an **AI · model** badge. Its audio plays inline like any
attachment, and **Add as stem** lays it onto the version's timeline.

### Finding AI-generated work later [#finding-ai-generated-work-later]

Every generated version and its track get the tags `ai` and `ai:<model>`, for
example `ai:lyria-3-pro`. Group the tracks board by tag or filter the list on
`ai` to see everything a model touched.

### Who can generate [#who-can-generate]

Admins only, while the feature is in preview. Non-admins do not see the
generate link or the comment buttons, and the page says so if they open it
directly. Guests on share links cannot generate.