suggest_next_track
ActiveTool of FreqBlog Music Metadata
declared in 1.27.2
Given a seed track, return the top-N catalog tracks to play NEXT, ranked by transition score. Each suggestion carries the same `score`, per-component scores and human `reason` as score_transition (e.g. "11B->11B same key, 118->117 BPM (-0.29), energy +0.12"). It is the seed's sonic neighbours re-ranked for a clean mix. Returns `seed`, `count`, and a `suggestions` array of {track, score, components, reason}. seed_track_id is a catalog itunes_track_id from search_catalog or a get_audio_features result. Pair with build_setlist to order a whole crate. Costs 3 quota units.
Parameters schema
{
"type": "object",
"title": "suggest_next_trackArguments",
"required": [
"seed_track_id"
],
"properties": {
"n": {
"type": "integer",
"title": "N",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "How many next-track suggestions to return (default 10)."
},
"bpm_drift": {
"type": "number",
"title": "Bpm Drift",
"default": 12,
"maximum": 30,
"minimum": 0.5,
"description": "Max BPM difference pre-filter before scoring (default 12)."
},
"min_score": {
"type": "integer",
"title": "Min Score",
"default": 0,
"maximum": 100,
"minimum": 0,
"description": "Drop candidates below this overall transition score (default 0)."
},
"seed_track_id": {
"type": "string",
"title": "Seed Track Id",
"maxLength": 80,
"minLength": 1,
"description": "The track currently playing — a catalog itunes_track_id."
},
"max_key_distance": {
"type": "integer",
"title": "Max Key Distance",
"default": 2,
"maximum": 12,
"minimum": 0,
"description": "Max Camelot-wheel hops pre-filter before scoring (default 2)."
},
"exclude_same_artist": {
"type": "boolean",
"title": "Exclude Same Artist",
"default": false,
"description": "Drop tracks by the seed's artist (default false)."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
FreqBlog Music Metadata
1/7 registries