recoupable Recoup Song — Analyze Audio
Everything you can learn from a single song's audio, via Music Flamingo. The
endpoint contract (auth, base URL, request/response, presets, gotchas) is in
references/flamingo-api.md — read it before calling. Needs a public audio_url
(no local upload); never put account_id in the body.
Sub-outputs (pick by ask, or give the full report)
- Full report — what it sounds like, references, standout qualities.
- Catalog metadata — BPM, key, genre, mood/energy (
catalog_metadata,music_theory) for tagging/registration. - Lyric sheet — sectioned transcription (
lyric_transcription). - Mix critique — technical feedback on the mix/master (
mix_feedback).
Run the presets the ask needs; synthesize a clean report (not raw JSON). In an
artist workspace, save to songs/{song-slug}/analysis/.
Guardrails
- Audio-grounded only — every claim (BPM, mood, mix note) comes from the Flamingo analysis; never guess from the title or vibes.
- Public URL required; no local upload; no
account_idin the body. - Lyrics: transcribe the artist's own song; don't reproduce third-party lyrics.
References
references/flamingo-api.md— auth, base URL, request/response, preset table.