Music

Lyrics Generation

Generate song lyrics from a text prompt using MiniMax. Use generated lyrics as input for music generation.

POST/v1/audio/lyrics

Request

Body Parameters

modestringrequired

Generation mode

Options: write_full_song, edit

promptstring

Description of the song theme, mood, or style (max 2000 chars). Omit for a random song.

lyricsstring

Existing lyrics to edit or continue (max 3500 chars). Required when mode is "edit".

titlestring

Song title (preserved in output if provided)

cURL

curl https://api.metriqual.com/v1/audio/lyrics \
  -H "Authorization: Bearer mql_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "write_full_song",
    "prompt": "A love song about summer nights"
  }'

TypeScript SDK

const lyrics = await mql.audio.generateLyrics({
  mode: 'write_full_song',
  prompt: 'A love song about summer nights'
});

console.log(lyrics.data.lyrics);

// Use lyrics for music generation
const music = await mql.music.generate({
  model: 'music-01',
  lyrics: lyrics.data.lyrics
});

Python SDK

lyrics = mql.audio.generate_lyrics(
    mode="write_full_song",
    prompt="A love song about summer nights",
)
print(lyrics["lyrics"])

# Use lyrics for music generation
music = mql.music.generate_with_lyrics(
    prompt="Pop ballad",
    lyrics=lyrics["lyrics"],
)

Response

200

{
  "object": "audio.lyrics",
  "song_title": "Summer Nights",
  "style_tags": "romantic, pop, summer",
  "lyrics": "[Verse 1]\nUnder the stars we dance tonight...",
  "latency_ms": 1250
}

Quick Start