Highlights

Overview

Extract highlight segments from audio or video based on energy peaks.

Analyses audio RMS energy to find the loudest moments and extracts them as a concatenated highlight reel.

Endpoint

POST https://eranol.com/api/v1/ffmpeg/audio/highlights

Request Body

{
  "url": "https://cdn.example.com/podcast.mp4",
  "top_n": 5,
  "segment_duration": 5
}

Response Example

{
  "job_id": "f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
  "status": "pending",
  "message": "Job created. Poll status_url for progress.",
  "job_type": "caption",
  "result_url": "https://eranol.com/api/v1/ffmpeg/result/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34",
  "status_url": "https://eranol.com/api/v1/ffmpeg/status/f595b9ad-1e15-4452-b7c2-8f8ff09c0a34"
}

Use Cases

1. Podcast highlight reel

Extract the loudest/most energetic moments from a 60-minute podcast to auto-generate a 90-second highlight clip.

Request Body

{
  "url": "https://cdn.example.com/podcast-episode.mp3",
  "top_n": 5,
  "max_duration": 90
}

Response

{
  "job_id": "1406c589-a1f4-45d5-8745-aae07bc4de38",
  "status": "pending",
  "message": "Job created. Poll status_url for progress.",
  "result_url": "https://eranol.com/api/v1/ffmpeg/result/1406c589-a1f4-45d5-8745-aae07bc4de38",
  "status_url": "https://eranol.com/api/v1/ffmpeg/status/1406c589-a1f4-45d5-8745-aae07bc4de38"
}

2. Sports clip — key moments

Pull the loudest audience-reaction peaks from a sports recording to generate a match highlights reel.

Request Body

{
  "url": "https://cdn.example.com/match-recording.mp4",
  "top_n": 8,
  "max_duration": 60
}

Response

{
  "job_id": "1406c589-a1f4-45d5-8745-aae07bc4de38",
  "status": "pending",
  "message": "Job created. Poll status_url for progress.",
  "result_url": "https://eranol.com/api/v1/ffmpeg/result/1406c589-a1f4-45d5-8745-aae07bc4de38",
  "status_url": "https://eranol.com/api/v1/ffmpeg/status/1406c589-a1f4-45d5-8745-aae07bc4de38"
}

3. Meeting recap — top talking points

Extract the highest-energy vocal moments from a recorded meeting to create a quick recap snippet.

Request Body

{
  "url": "https://cdn.example.com/all-hands-meeting.mp4",
  "top_n": 6,
  "max_duration": 120
}

Response

{
  "job_id": "1406c589-a1f4-45d5-8745-aae07bc4de38",
  "status": "pending",
  "message": "Job created. Poll status_url for progress.",
  "result_url": "https://eranol.com/api/v1/ffmpeg/result/1406c589-a1f4-45d5-8745-aae07bc4de38",
  "status_url": "https://eranol.com/api/v1/ffmpeg/status/1406c589-a1f4-45d5-8745-aae07bc4de38"
}

Error Codes

Code	Meaning
401	Missing or invalid API key
402	Insufficient credits
422	Validation error — check your request body
429	Rate limit exceeded — slow down requests
500	Internal server error — try again or contact support