WAN 3.0 is LIVE — 30s in one shot | Try in Video Generator →

minimax/

MiniMax Lyrics Generation creates complete song lyrics from natural-language prompts, and can edit or continue existing lyrics with structured output including a title, style tags, and lyrics ready for music generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-audio
Input

Idle

minimax/lyrics-generation preview unavailable

$0.02per run·~50 / $1

ExamplesView all

A cinematic synth-pop love song set in a neon city at midnight, dreamy female vocals, intimate verses, a memorable soaring chorus, bittersweet but hopeful, with vivid rain and streetlight imagery.

A cinematic synth-pop love song set in a neon city at midnight, dreamy female vocals, intimate verses, a memorable soaring chorus, bittersweet but hopeful, with vivid rain and streetlight imagery.

Related Models

README

MiniMax Lyrics Generation

MiniMax Lyrics Generation creates complete song lyrics or edits and continues an existing draft from natural-language instructions. It returns a song title, comma-separated style tags, and lyrics with structure tags that can be used directly with MiniMax Music 3.0.

Why Choose This?

  • Complete song lyrics
    Turn a theme, mood, genre, or story idea into structured lyrics for a full song.

  • Editing and continuation
    Revise, rewrite, or continue existing lyrics while preserving the creative direction you provide.

  • Music-ready structure
    The generated lyrics can include tags such as [Verse], [Chorus], [Bridge], and [Outro] for downstream song generation.

  • Useful metadata
    Each result includes a song title and style tags alongside the lyrics.

  • Simple fixed pricing
    Every generation or edit request has the same price, regardless of prompt length.

Parameters

ParameterRequiredDescription
modeYeswrite_full_song creates complete lyrics; edit edits or continues existing lyrics. Default: write_full_song.
promptNoSong theme, style, mood, story, or editing instruction. Maximum length: 2000 characters. Leave empty in full-song mode for a random song.
lyricsNoExisting lyrics to edit or continue. Used only in edit mode. Maximum length: 3500 characters.
titleNoOptional song title. When provided, the output keeps this title unchanged.

How to Use

  1. Choose a mode — use write_full_song for new lyrics or edit for an existing draft.
  2. Describe the song — provide the theme, genre, mood, story, voice, or editing direction in prompt.
  3. Add existing lyrics when editing — paste the draft into lyrics when using edit mode.
  4. Optionally set a title — provide title when it must remain unchanged.
  5. Submit — receive a title, style tags, and structured lyrics.

Example Prompt

A cinematic synth-pop love song set in a neon city at midnight, dreamy female vocals, intimate verses, a memorable soaring chorus, bittersweet but hopeful, with vivid rain and streetlight imagery.

Pricing

Just $0.02 per request.

Output

The model returns:

  • song_title — generated or preserved song title
  • style_tags — comma-separated musical and vocal style tags
  • lyrics — generated lyrics with song structure tags

Supported structure tags include [Intro], [Verse], [Pre-Chorus], [Chorus], [Hook], [Drop], [Bridge], [Solo], [Build-up], [Instrumental], [Breakdown], [Break], [Interlude], and [Outro].

Best Use Cases

  • Songwriting ideation — create a complete first draft from a concept.
  • Verse and chorus development — strengthen or continue unfinished sections.
  • Lyric rewriting — change mood, genre, imagery, or point of view.
  • Demo preparation — generate structured lyrics ready for AI music creation.
  • Creative content — write themed songs for videos, ads, games, and social media.

Pro Tips

  • Include the genre, mood, narrator, setting, imagery, and desired emotional arc.
  • Ask for a clear verse/chorus/bridge structure when arrangement matters.
  • In edit mode, explain exactly what to preserve and what to change.
  • Set title when your project already has a fixed song name.
  • Pass the returned lyrics into MiniMax Music 3.0 to generate a complete song.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Lyrics Generation API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/minimax/lyrics-generation with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Lyrics Generation below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "mode": "write_full_song"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/minimax/lyrics-generation" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "$TASK" | jq -r '.urls.get // empty')
if [ -z "$RESULT_URL" ]; then
  RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "$STATUS" >&2; exit 1 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/minimax/lyrics-generation";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "mode": "write_full_song"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = task.urls?.get ||
  `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout"].includes(result.status)) throw new Error(JSON.stringify(result));
  if (!["created", "processing"].includes(result.status)) throw new Error("Unexpected status: " + result.status);
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "mode": "write_full_song"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/minimax/lyrics-generation", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = task.get("urls", {}).get("get") or f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout"}:
        raise RuntimeError(result)
    if status not in {"created", "processing"}:
        raise RuntimeError(f"Unexpected status: {status}")
    time.sleep(2)

Lyrics Generation API — Frequently asked questions

What is the Lyrics Generation API?

Lyrics Generation is a MiniMax model for audio generation, exposed as a REST API on WaveSpeedAI. MiniMax Lyrics Generation creates complete song lyrics from natural-language prompts, and can edit or continue existing lyrics with structured output including a title, style tags, and lyrics ready for music generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Lyrics Generation API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/minimax/minimax-lyrics-generation.

How much does Lyrics Generation cost per run?

Lyrics Generation starts at $0.020 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Lyrics Generation accept?

Key inputs: `prompt`, `lyrics`, `mode`, `title`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/minimax/minimax-lyrics-generation.

How do I get started with the Lyrics Generation API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Lyrics Generation outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (MiniMax). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

MiniMax Lyrics Generation API on WaveSpeedAI