Convert MP3 to WAV
To convert MP3 to WAV, send one POST to /v1/audio-convert with the MP3 source and "to": "wav" in the body. Left out, "to" falls back to its default "mp3", so a WAV request has to send it. Each call costs $0.003 in USDC on Base via x402, with no account and no API key. The source file can be up to 100 MB and 60 min (3,600 s) long.
Agents read this page asGET /v1/audio-convert/schemafree: schema, examples, errors, price
- Endpoint
- POST /v1/audio-convert
- Price
- $0.003 per call
- Selects the target
- "to": "wav"
Limits
| Limit | Value |
|---|---|
| Largest source file | 100 MB (104,857,600 bytes) |
| Longest input | 60 min (3,600 s) |
| Timeout | 94 s |
| Source formats | AIFF, AVI, FLAC, MKV, MP3, MP4, Ogg, WAV |
| Output formats | AAC, FLAC, MP3, Opus, WAV |
Example
A real MP3 to WAV run of audio-convert.
POST /v1/audio-convert
content-type: application/json
payment-signature: <base64 x402 payload>
{
"url": "https://grist.tools/samples/av/pair-tone.mp3",
"to": "wav"
}200 OK
payment-response: <base64 settlement receipt>
{
"source_url": "https://grist.tools/samples/av/pair-tone.mp3",
"bytes": 12980,
"source_container": "mp3",
"format": "wav",
"bitrate_kbps": null,
"sample_rate": null,
"audio_bytes": 48044,
"audio_base64": "UklGRqS7AABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YYC7AABg40Po..."
}Source file: av/pair-tone.mp3, 12.7 KB (12,980 bytes). 3 s mono 8 kHz MP3 at 32 kbit/s, encoded by ffmpeg's libmp3lame with the bit-exact flags: three 0.5 s 500 Hz triangle beeps at rising level, each followed by 0.5 s of silence. The recorded run returned 46.9 KB (48,044 bytes) of WAV, 3.7 times the source size, with the source read as the mp3 container. Decoded, the WAV in audio_base64 opens with 52 49 46 46 A4 BB 00 00 57 41 56 45 (ASCII RIFF and WAVE). Recorded with ffmpeg 8.1.2.
In the sample itself: the file opens with an ID3v2.4 tag with 10 bytes of body, then an MPEG 2.5 Layer III frame header at byte 20: 32 kbps, 8,000 Hz, mono. That first frame is an Info header rather than audio, and it counts 44 audio frames and 12,960 bytes. In the returned WAV: the RIFF header counts 48,036 bytes after itself, and the fmt chunk, in its own field order, declares audio format 1 (integer PCM), 1 channel, 8,000 Hz, 16,000 bytes per second, a block align of 2 bytes and 16 bits per sample. The data chunk right after it holds 48,000 bytes of samples, 3 s at that rate.
Format notes
MP3 as a source
MP3 is lossy audio. Grist accepts it when the file opens with an ID3v2 tag or with a bare MPEG audio frame sync: the byte FF followed by a byte whose top three bits are set. That sync test also matches a raw ADTS AAC stream, and because nothing proves ffmpeg would then pick the right demuxer, AAC is kept out of the sources. Duration needs care with MP3. For a file without a Xing header, the probe estimates length by dividing file size by the bitrate of the first frames, which a crafted variable-bitrate file can falsify, so any probe warning sends the measurement to a scan of real packet timestamps. Once accepted, the first audio stream is decoded by ffmpeg; a lossless destination stores the decoded samples without recovering what MP3 encoding discarded.
WAV as a target
Every WAV that audio-convert writes holds signed little-endian PCM from the pinned pcm_s16le codec, whatever encoding the source used. The RIFF header records chunk sizes that are only known once the last sample is written, and the WAV muxer fills them in when the file closes, so ffmpeg cannot stream this format to a pipe: it writes a seekable temporary file inside the per-call directory and Grist reads that file back. Sending bitrate_kbps for this lossless destination is rejected instead of being ignored. sample_rate is optional and limited to the closed set the service lists; without it ffmpeg chooses, normally keeping the source rate. Video, metadata and chapters are left behind, and only the first audio stream is mapped. With the pinned ffmpeg and bit-exact flags, the same input yields the same bytes. When the source was lossy, the WAV is the decoded result at full size: uncompressed, yet no detail the earlier codec discarded comes back.
Errors
When each is raised, and what it means for payment: /docs/audio-convert.
Questions
What does it cost to convert MP3 to WAV?
$0.003 per call, paid in USDC on Base via x402.
How large can the MP3 file be?
Up to 100 MB (104,857,600 bytes), and at most 60 min (3,600 s) of media. Past a limit the call answers too_large (413).
What happens if the conversion fails?
The tool answers with a typed JSON error from the errors table. Payment is settled only after the tool has produced its result; a call that fails inside the tool is never settled.