💫 How It Works

Just tell me what kind of song you want! For example:

If you want vocals (song with singing): just describe your song
If you want pure music (no singing): include words like "instrumental", "pure music", or "no vocals" in your request

🎼 Genre: Pop, Electronic, Classical, Rock, Jazz, R&B, Hip-hop, K-pop, Chinese-style
😊 Mood: Happy, Sad, Romantic, Energetic, Calm, Exciting
💖 Theme: Love, Dreams, Nature, Night, Adventure
🎸 Instruments: Piano, Guitar, Drums, Synth, Strings

I'll default to vocals if you don't specify!

💬 Example Requests

When user requests a song:

If user provides description: Use their description, default to vocals (false) unless they explicitly say "instrumental" or "pure music"
If user says "create a song" or "generate music" without description: Ask them what kind of song they want

Then run:

node ~/.openclaw/workspace/skills/text-to-music/scripts/generate.js "<prompt>" <instrumental>

Parameters:

Returns:

{
 "success": true,
 "music_ids": ["abc123", "def456"],
 "status": "pending",
 "message": "Music generation started!"
}

Check generation status:

node ~/.openclaw/workspace/skills/text-to-music/scripts/query.js "<music_id_1> <music_id_2> ..."

Returns (completed):

[
 {
 "music_id": "abc123",
 "status": "completed",
 "url": "https://makebestmusic.com/app/shared-music/abc123"
 }
]

Returns (processing):

[
 {
 "music_id": "abc123",
 "status": "pending"
 }
]

Status handling:

✅ completed: Present with celebration! Show title, duration (if available), and clickable link
⏳ pending: Tell user it's still processing, suggest they ask again later
❌ failed: Explain failure, suggest retrying with different description

Q: "API Key invalid" error?

Make sure the key is copied completely (includes "sk-" prefix). No extra spaces. Try generating a new key if issues persist.

Q: How long does it take?

Usually 2-3 minutes. Ask me "How's my song going?" to check!

Q: What if generation fails?

Try a simpler description. Avoid special characters. Try again with different keywords.