FastAPI service

Audio Extractor

Upload a video or audio file, choose an output format, and the service extracts or re-encodes the audio track through ffmpeg. Multiple files can be processed at the same time.

API Usage

Send a file, poll task status, then download the extracted audio. The service processes tasks through a background worker pool.

Base URL: {domain}

1. Create Task

target_format is one of: source, wav, mp3, flac, aac, ogg. Defaults to source.

curl -X POST "{domain}/api/v1/extract" \
  -F "file=@video.mp4" \
  -F "target_format=wav"

2. Poll Status

Poll every few seconds until the status becomes completed, failed, or expired.

curl "{domain}/api/v1/status/{task_id}"

3. Download Result

When status is completed, use the returned download URL. Files expire after 24 hours.

curl -O "{domain}/media/downloads/{filename}"

Status responses include status, queue_position, queue_size, progress_percent, and progress_message. Failed or expired tasks include error.