Extract audio track from a video

Overview

Extract audio track from a video file as WAV.

Default: mono (1 channel). Set "mono": false to keep all channels.

Endpoint

POST https://eranol.com/api/v1/ffmpeg/video/extract/audio

Request Body

{
  "url": "https://www.soundhelix.com/examples/mp3/SoundHelix-Song.mp4",
  "mono": true
}

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. Extract mono voiceover for TTS pipeline

Pull out the mono audio track from a talking-head video before passing it to a speech-to-text service.

Request Body

{
  "url": "https://cdn.example.com/talking-head.mp4",
  "mono": true
}

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. Extract stereo music from a music video

Keep both stereo channels when extracting audio from a music video for mastering purposes.

Request Body

{
  "url": "https://cdn.example.com/music-video.mp4",
  "mono": false
}

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 audio from a screen recording

Separate the narration audio from a screen recording so it can be run through noise reduction before merging back.

Request Body

{
  "url": "https://cdn.example.com/screen-recording.mp4"
}

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