openrouter-text2music

name	openrouter-text2music
description	Generate music (NOT speech) via OpenRouter using Google Lyria 3 Pro.

openrouter-text2music

Text → music via OpenRouter. Default model: google/lyria-3-pro-preview.

⚠️ This is a music-generation model, not TTS. It produces 48kHz stereo audio with instrumentation, and can include vocals and timed lyrics based on the prompt. For narration/voiceover, use a dedicated TTS tool (e.g., OpenAI tts-1, ElevenLabs).

Usage

Resolve TOOL_DIR = the directory containing this SKILL.md. Commands below use TOOL_DIR as a symbolic placeholder; replace it with the resolved, quoted path before running Bash.

export OPENROUTER_API_KEY=sk-or-v1-...

python3 TOOL_DIR/scripts/generate_music.py \
  --prompt "Driving synthwave, 120 BPM, nostalgic lead over a pulsing arpeggio, no vocals" \
  --download PROJECT_DIR/assets/bg_music.wav

Flags

Flag	Default	Description
--prompt	required	Text prompt (genre, mood, instruments, tempo, optional lyrics)
--download	required	Output audio file path
--model	google/lyria-3-pro-preview	Alt: google/lyria-3-clip-preview (shorter clips)

Pricing

• lyria-3-pro-preview: $0.08 per song

Notes

• Request uses POST /api/v1/chat/completions with modalities: ["audio","text"].
• Response parsing handles several shapes: message.audio, a content part with type=audio, or a data:audio/... URL embedded in the text content.
• Output format is typically WAV (48kHz stereo); the script saves whatever bytes the API returns — choose the extension to match.