Browse Docs
Archives (14)
Audio (38)
Documents (26)
Ebooks (7)
Fonts (13)
Images (62)
Video (10)
On This Page

AUDIO to MARKDOWN

Convert audio files to Markdown transcripts. Supports three transcription modes — fast, quality, and meeting intelligence — with configurable output formats.

Try Audio to Markdown in the browser →

Convert.FAST uses this same API — what you see in the browser is what you get in code.

Quick reference

Job typeaudio.audio-to-markdown
targetFormatmd
Categoryaudio
Input formats.mp3, .wav, .m4a, .flac, .ogg, .opus, .aac, .webm, .mp4, .mkv, .mov, .avi
Output extension.md
Costing2 credit per minute
Cost by transcription modeFast: 2 credits/minute (default) · Quality: 5 credits/minute · Meeting Intelligence: 8 credits/minute
Max file size1 GB
Max duration300 min

Example

cURL
# 1) Submit
JOB_ID=$(curl -sS -X POST "https://api.tools.fast/convert" \
  -H "X-Fast-Api-Key: $API_KEY" \
  -F "file=@audio.mp3" \
  -F "targetFormat=md" | jq -r '.id')
# → 202 Accepted: {"id": "019e3a7b-...", "status": "Queued"}

# 2) Poll until terminal status
while true; do
  RESPONSE=$(curl -sS "https://api.tools.fast/convert/job/${JOB_ID}" \
    -H "X-Fast-Api-Key: $API_KEY")
  STATUS=$(echo "$RESPONSE" | jq -r '.status')
  [ "${STATUS}" = "Succeeded" ] && break
  [ "${STATUS}" = "Failed" ] || [ "${STATUS}" = "Canceled" ] && { echo "$RESPONSE" | jq; exit 1; }
  sleep 1
done

# 3) Download
curl -sS "https://api.tools.fast/convert/job/${JOB_ID}/download" \
  -H "X-Fast-Api-Key: $API_KEY" \
  -o "audio.md"
# → Binary file (text/markdown, 1.2 MB)

Options

This converter supports the following options. See Options Reference for full details.

OptionDescriptionDefault
transcriptionAudio transcription settings — mode, output formats, and primary formatmode: fast, includeTxt: false, includeSrt: false, includeVtt: false, includePdf: false, includeDocx: false, includeMarkdown: false, includeEpub: false

Multi-format output: Audio transcription can produce multiple formats in a single job. The endpoint you call sets the primary format; use the include* flags to add additional formats. See Options Reference for all available settings.

Cost estimate

cURL
curl -sS "https://api.tools.fast/convert/estimate/mp3/md?durationMinutes=10"

# With transcription mode variant (Meeting Intelligence)
curl -sS "https://api.tools.fast/convert/estimate/mp3/md?durationMinutes=10&variant=meeting-intelligence"
Copied.