apyhub
AUDIO PROCESSING · FILE CONVERSION

Audio Extractor from Video API

What it does

Video Audio Extractor pulls audio from a video source and returns it as a downloadable file or a signed cloud link. Send either a video_url or an uploaded video, then choose whether you want the full audio track or just a segment.

Use start_time to set the seek offset, duration to control how many seconds to extract, and output_format to choose the format: mp3, wav, aac, ogg, flac, wma, or ac3. When full_audio is enabled, the service ignores duration and extracts the complete track.

The service exposes URL-based and multipart upload workflows, so you can handle both remote media and local files. For URL requests, you can download the binary output directly or receive a time-limited signed URL in data. For uploaded videos, the same output options are available.

Use Video Audio Extractor when you need to isolate narration from a training clip, pull a soundtrack from a user-uploaded video, or generate an audio asset for downstream processing in your pipeline.

▣ ENDPOINT 01 / 04
POST
Extract audio from video (URL → download)
https://api.eu.apyverse.com/apyhub/extract-audio-video/url/download

QUICKSTART

GUIDE

Quickstart

Send a video URL to extract audio from and get the audio file back.

curl -X POST "https://api.eu.apyverse.com/apyhub/extract-audio-video/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://assets.apyhub.com/samples/sample.mp4"}'

What you'll get back

Returns a binary file stream (string with format: binary) containing the extracted audio.

[audio file download]
TRY ITLIVE · 550 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Number of seconds to extract. Ignored when full_audio is true.
Seek offset in seconds (string).

About this endpoint

What it does

Extracts audio from a video file provided by URL and returns the resulting audio as a binary download. You can optionally control the start time, duration, whether to extract the full audio track, and the output format.

Request Body

ParameterTypeMandatoryDescription
video_urlStringYesVideo URL to extract audio from. Must be a URI.
durationStringNoNumber of seconds to extract. Default: 2. Ignored when full_audio is true.
full_audioBooleanNoWhen true, extracts the full audio track. Default: false.
start_timeStringNoSeek offset in seconds. Default: 0.
output_formatENUMNoOutput audio format. Allowed values: mp3, wav, aac, ogg, flac, wma, ac3. Default: mp3.

Response

Returns a binary file download containing the extracted audio. The success response is a single binary string payload, not a JSON object.

ParameterTypeMandatoryDescription
binaryStringYesThe extracted audio file content returned as binary data.

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 03 / 04
POST
Extract audio from video (upload → download)
https://api.eu.apyverse.com/apyhub/extract-audio-video/multi-part/download

QUICKSTART

GUIDE

Quickstart

Extract audio from a video file and download the resulting audio stream.

curl -X POST "https://api.eu.apyverse.com/apyhub/extract-audio-video/multi-part/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4"

What you'll get back

Returns a binary file stream (string with format: binary) containing the extracted audio.

<binary audio file>
TRY ITLIVE · 550 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
Video file (.mp4 .mkv .avi .mov .flv .3gp .webm)
Number of seconds to extract. Ignored when `full_audio` is true.
When true, extract the complete audio track.
Seek offset in seconds.

About this endpoint

What it does

Extracts audio from an uploaded video file and returns the resulting audio as a binary file. The request accepts a video upload plus optional extraction settings such as duration, start time, full-audio mode, and output format.

Request Body

ParameterTypeMandatoryDescription
videoStringYesVideo file upload. Supported formats: .mp4, .mkv, .avi, .mov, .flv, .3gp, .webm.
durationIntegerNoNumber of seconds to extract. Default: 2. Minimum: 0. Ignored when full_audio is true.
full_audioENUMNoWhether to extract the complete audio track. Allowed values: true, false, 1, 0. Default: false.
start_timeIntegerNoSeek offset in seconds. Default: 0. Minimum: 0.
output_formatENUMNoOutput audio format. Allowed values: mp3, wav, aac, ogg, flac, wma, ac3. Default: mp3.

Response

Returns a binary string containing the extracted audio file.

ParameterTypeMandatoryDescription
dataStringYesBinary audio output.

Body

Name
Type
Description
bodyREQUIRED
object

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 04 / 04
POST
Extract audio from video (upload → cloud link)
https://api.eu.apyverse.com/apyhub/extract-audio-video/multi-part/link

QUICKSTART

GUIDE

Quickstart

Upload a video file to extract audio and get back a signed download URL.

curl -X POST "https://api.eu.apyverse.com/apyhub/extract-audio-video/multi-part/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4"

What you'll get back

Returns a JSON object with a data string field containing a time-limited signed URL for download.

{
  "data": "https://apyverse-dev-outgoing.s3.eu-west-1.amazonaws.com/mono-go/video-audio/general/video-clips_2026-07-05_d20230d0..mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA2Q3FC7EXNYY64ZXU%2F20260705%2Feu-west-1%2Fs3%2Faws4_request&X-Amz-Date=20260705T181017Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=inline&response-content-type=audio%2Fmpeg&X-Amz-Signature=c1a55d47c3623c8c4a524bdc632d5173fa61022a2a0f4e1c2274e1bf098eb1a5"
}
TRY ITLIVE · 550 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*

About this endpoint

What it does

Extracts audio from an uploaded video file and returns a time-limited signed URL where the extracted audio can be downloaded.

Request Body

ParameterTypeMandatoryDescription
videoStringYesVideo file to process. Binary upload.
durationIntegerNoNumber of units to extract. Default: 2. Minimum: 0.
full_audioENUMNoWhether to extract the full audio track. Allowed values: true, false, 1, 0. Default: false.
start_timeIntegerNoStart offset for extraction. Default: 0. Minimum: 0.
output_formatENUMNoOutput audio format. Allowed values: mp3, wav, aac, ogg, flac, wma, ac3. Default: mp3.

Response

Returns a JSON object with a data string field formatted as a URI. The data value is a time-limited signed URL for download.

AttributeTypeMandatoryDescription
dataStringNoTime-limited signed URL for download.

Body

Name
Type
Description
bodyREQUIRED
object

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.