▣ AUDIO PROCESSING · FILE CONVERSION

Convert WAV to MP3 API

Hosted on ApyHub

What it does

WAV to MP3 Converter converts WAV audio files into MP3, either from a direct multipart upload or from a publicly accessible file URL. You can choose between a streamed binary download or a signed link to the converted MP3.

Send a WAV file in the file field to the multipart endpoints, or send a source url for the URL-based endpoints. The upload path supports files up to 100 MB. If you need the converted audio immediately, use the download endpoints and receive the MP3 as binary output. If you want to hand off the result asynchronously, use the link endpoints and get back a data URI pointing to the generated MP3.

This is useful when you need to standardise audio assets for playback, storage, or downstream processing. For example, you can convert uploaded recordings before saving them in a media pipeline, or fetch a WAV from object storage and return an MP3 for delivery to another system.

Choose the multipart route when the source file is already in your request, and the URL route when the WAV lives elsewhere and is reachable over HTTPS.

▣ ENDPOINT 01 / 04

POST

Convert WAV to MP3 (multipart upload, stream download)

http://localhost:8080/apyhub/convert-wav-to-mp3/multi-part/download

QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/apyhub/convert-wav-to-mp3/multi-part/download?output=converted-audio" \
  -H "apy-token: $APY_TOKEN" \
  -d '{"file":"<base64-encoded-wav-file>"}'

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

API key

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.

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)

Attribute	Type	Mandatory	Description
output	String	No	Output name/value for the converted file. Example: `converted-audio`.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	WAV 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.

Parameter	Type	Mandatory	Description
response	String	Yes	Binary 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)

http://localhost:8080/apyhub/convert-wav-to-mp3/multi-part/link

QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/apyhub/convert-wav-to-mp3/multi-part/link" \
  -H "apy-token: $APY_TOKEN" \
  -d '{"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

API key

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.

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

Parameter	Type	Mandatory	Description
file	String	Yes	WAV 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.

Parameter	Type	Mandatory	Description
data	String	Yes	Signed 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)

http://localhost:8080/apyhub/convert-wav-to-mp3/url/download

QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/apyhub/convert-wav-to-mp3/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.wav"}'

What you'll get back

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

<binary data>

TRY ITLIVE · 100 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

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)

Attribute	Type	Mandatory	Description
output	String	No	Output filename prefix. Example: `converted-audio`.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	Publicly accessible URL of the source WAV audio file. Format: URI.

Response

Returns a binary file containing the converted MP3 audio.

Parameter	Type	Mandatory	Description
binary	String	Yes	Binary 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)

http://localhost:8080/apyhub/convert-wav-to-mp3/url/link

QUICKSTARTGUIDE

Quickstart

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

curl -X POST "http://localhost:8080/apyhub/convert-wav-to-mp3/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -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

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

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

Parameter	Type	Mandatory	Description
url	String	Yes	Publicly 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.

Parameter	Type	Mandatory	Description
data	String	Yes	Signed 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.