recoup-song-find-hook
Recoup Song — Find Hook
Find the moments most likely to stop the scroll, for short-form. Uses Music
Flamingo — the endpoint contract is in references/flamingo-api.md (read first).
Needs a public audio_url; never put account_id in the body.
Procedure
Run sync_brief_match (energy curve + timestamped moments) + music_theory (so a
window snaps to a real section boundary, not an arbitrary cut) + lyric_transcription
(the quotable line). The best hook is where energy + section change + a quotable
line coincide.
Return 3 ranked windows, each with start–end (target 5–15s; ≈7s if it must
loop), the moment type (drop/chorus/beat-switch/peak), the quotable line, and one
line on why it stops the scroll. Timestamps come from the analysis, not vibes — they
feed real edits; hand them to recoup-content-make-video. Save to
songs/{song-slug}/analysis/hooks.md.