Cut

Overview

Cut a video into multiple segments and concatenate them into a single output.

Each entry in segments defines a start and end time (in seconds) to extract from the source video. The extracted segments are joined together, in the order given, into one output file.

Endpoint

POST https://eranol.com/api/v1/ffmpeg/video/cut

Request Body

{
  "url": "https://cdn.example.com/video.mp4",
  "segments": [
    { "start_sec": 5, "end_sec": 9 },
    { "start_sec": 90, "end_sec": 98 }
  ]
}

Response Example

[
  {
    "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"
  }
]

Use Cases

1. Remove a mid-roll mistake

Cut out a flubbed section in the middle of a recording by keeping only the segments before and after it.

Request Body

{
  "url": "https://cdn.example.com/podcast-raw.mp4",
  "segments": [
    { "start_sec": 0, "end_sec": 120 },
    { "start_sec": 145, "end_sec": 600 }
  ]
}

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. Build a highlight reel

Stitch together several standout moments from a long stream or game recording into one short clip.

Request Body

{
  "url": "https://cdn.example.com/stream-vod.mp4",
  "segments": [
    { "start_sec": 320, "end_sec": 335 },
    { "start_sec": 1024, "end_sec": 1041 },
    { "start_sec": 2200, "end_sec": 2210 }
  ]
}

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. Extract two clips for social media

Pull two separate short moments out of a longer video and combine them into a single teaser clip.

Request Body

{
  "url": "https://cdn.example.com/vetrasns.mp4",
  "segments": [
    { "start_sec": 5, "end_sec": 9 },
    { "start_sec": 90, "end_sec": 98 }
  ]
}

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