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.

Guardrails

• Audio-grounded only — windows come from the analysis, never guessed.
• Hook windows are 5–15s — a 40s "hook" isn't a hook.
• Public URL required; no account_id in the body.

References

• references/flamingo-api.md — presets + call patterns.