apyhub
Back
AUDIO PROCESSING · FILE CONVERSION

WAV to MP3 Converter API

Hosted on ApyHub

What it does

The WAV to MP3 Converter API turns WAV audio into MP3, which is typically much smaller and plays everywhere. Upload a WAV file (up to 100 MB) or send the URL of a WAV hosted elsewhere, and choose how you want the result: the MP3 file itself, returned directly in the response, or a signed link you can store or share.

Use it to shrink recordings before storing them, prepare audio for web and mobile playback, or standardize files coming from different sources in a media pipeline. Pair it with the Speech to Text API to transcribe recordings, or use the MP3 to WAV API when you need to convert the other way.

Pick the endpoint that fits your setup: upload endpoints when the file is already in your app, URL endpoints when it lives in cloud storage or on another server. You can start on ApyHub's free tier with no card required.

▣ ENDPOINT 01 / 04
POST
Convert WAV to MP3 (multipart upload, stream download)
https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/multi-part/download

QUICKSTART

GUIDE

Quickstart

Convert a WAV file to MP3 by uploading the audio file and choosing an output name.

curl -X POST "https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/multi-part/download?output=converted-audio" \
  -H "apy-token: $APY_TOKEN" \
   -F "file=@/path/to/audio.wav"

What you'll get back

Returns a binary file (string with format: binary) containing the converted MP3 audio.

<mp3 file bytes>
TRY ITLIVE · 100 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*
WAV audio file to convert (max 100 MB).

About this endpoint

What it does

Converts an uploaded WAV audio file to MP3 and returns the converted audio as a binary response. The request sends the source file in the multipart body and can optionally include an output query parameter.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOutput name/value for the converted file. Example: converted-audio.

Request Body

ParameterTypeMandatoryDescription
fileStringYesWAV audio file to convert. Binary upload. Maximum size: 100 MB.

Response

Returns a binary file response containing the converted MP3 audio. The success response is a binary payload with no JSON wrapper or top-level fields.

ParameterTypeMandatoryDescription
responseStringYesBinary MP3 audio content returned by the endpoint.

Query parameters

Name
Type
Description
outputOPTIONAL
string

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 02 / 04
POST
Convert WAV to MP3 (multipart upload, return signed link)
https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/multi-part/link

QUICKSTART

GUIDE

Quickstart

Upload a WAV file to get back a link to the converted MP3.

curl -X POST "https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/multi-part/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/audio.wav"

What you'll get back

Returns a JSON object with a data string field containing a URI to the generated MP3 file.

{
  "data": "https://storage.example.com/audio/output.mp3?sig=abc"
}
TRY ITLIVE · 100 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*
WAV audio file to convert (max 100 MB).

About this endpoint

What it does

Converts an uploaded WAV file to MP3 and returns a signed link to the converted audio. The request sends the file in the body, and the response contains a URI string in data.

Request Body

ParameterTypeMandatoryDescription
fileStringYesWAV audio file to convert. Binary upload format. Max 100 MB.

Response

Returns a JSON object with a data string field containing a URI to the converted MP3 file.

ParameterTypeMandatoryDescription
dataStringYesSigned link to the converted MP3 file. Format: URI.

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 03 / 04
POST
Convert WAV to MP3 (fetch by URL, stream download)
https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/url/download

QUICKSTART

GUIDE

Quickstart

Convert a WAV file from a public URL to MP3 by sending the source file URL.

curl -X POST "https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://assets.apyhub.com/samples/sample.wav"
  }'

What you'll get back

Returns the converted MP3 as a binary file response. The example above saves the file locally as converted.mp3.

TRY ITLIVE · 100 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*
Publicly accessible URL of the source WAV audio file.

About this endpoint

What it does

Converts a WAV audio file fetched from a public URL into MP3 and returns the converted file as a binary download. The request body supplies the source url, and the output query parameter can be used to name the output.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOutput filename prefix. Example: converted-audio.

Request Body

ParameterTypeMandatoryDescription
urlStringYesPublicly accessible URL of the source WAV audio file. Format: URI.

Response

Returns a binary file containing the converted MP3 audio.

ParameterTypeMandatoryDescription
binaryStringYesBinary response body for the converted audio file.

Query parameters

Name
Type
Description
outputOPTIONAL
string

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 04 / 04
POST
Convert WAV to MP3 (fetch by URL, return signed link)
https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/url/link

QUICKSTART

GUIDE

Quickstart

Convert a public WAV file to MP3 by sending its URL.

curl -X POST "https://api.eu.apyhub.com/apyhub/convert-wav-to-mp3/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://assets.apyhub.com/samples/sample.wav"
  }'

What you'll get back

Returns a JSON object with a data string field containing the MP3 file URL.

{
  "data": "https://storage.example.com/audio/output.mp3?sig=abc"
}
TRY ITLIVE · 100 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*
Publicly accessible URL of the source WAV audio file.

About this endpoint

What it does

Converts a WAV audio file fetched from a publicly accessible URL into MP3 and returns a signed URL to the converted file.

Request Body

ParameterTypeMandatoryDescription
urlStringYesPublicly accessible URL of the source WAV audio file. Must be a URI.

Response

Returns a JSON object with a data string field containing a signed URI to the converted MP3 file.

ParameterTypeMandatoryDescription
dataStringYesSigned URI for the converted MP3 file.

Body

Name
Type
Description
bodyREQUIRED
object
▣ 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.