Audio Operations

Convert audio files between formats with customizable bitrate and quality settings.

Convert Audio

POST /api/v1/jobs/audio/convert

Convert audio files to different formats with quality control.

Request Body

{
  "source_bucket": "my-bucket",
  "source_key": "audio/song.mp3",
  "dest_bucket": "my-bucket",
  "dest_key": "audio/song.opus",
  "format": "opus",
  "bitrate": "128k"
}

Parameters

Parameter	Type	Required	Description
`source_bucket`	string	✅	Source S3 bucket
`source_key`	string	✅	Source S3 key (audio file)
`dest_bucket`	string	✅	Destination S3 bucket
`dest_key`	string	✅	Destination S3 key (audio file)
`format`	string	✅	Output format: `mp3`, `aac`, `opus`, `ogg`, `flac`, `wav`, `m4a`
`bitrate`	string	❌	Target bitrate (e.g., `128k`, `192k`, `320k`)

Response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Job queued for processing"
}

Examples

curl -X POST http://localhost:8080/api/v1/jobs/audio/convert \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "source_bucket": "my-bucket",
    "source_key": "song.mp3",
    "dest_bucket": "my-bucket",
    "dest_key": "song.aac",
    "format": "aac",
    "bitrate": "192k"
  }'

curl -X POST http://localhost:8080/api/v1/jobs/audio/convert \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "source_bucket": "my-bucket",
    "source_key": "recording.wav",
    "dest_bucket": "my-bucket",
    "dest_key": "recording.flac",
    "format": "flac"
  }'

const response = await fetch('http://localhost:8080/api/v1/jobs/audio/convert', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  },
  body: JSON.stringify({
    source_bucket: 'my-bucket',
    source_key: 'audio.mp3',
    dest_bucket: 'my-bucket',
    dest_key: 'audio.opus',
    format: 'opus',
    bitrate: '128k'
  })
});
const data = await response.json();

Supported Formats

MP3

Universal compatibility, good compression

Recommended bitrate: 128k-320k

AAC

Better quality than MP3 at same bitrate

Recommended bitrate: 128k-256k

Opus

Best compression, ideal for streaming

Recommended bitrate: 64k-128k

OGG Vorbis

Open format, good quality

Recommended bitrate: 128k-192k

FLAC

Lossless compression, archival quality

No bitrate needed (lossless)

WAV

Uncompressed, professional use

No bitrate needed (uncompressed)

Bitrate Guidelines

Choose the right bitrate for your use case:

Bitrate	Quality	Use Case
64k	Low	Voice, podcasts, minimal bandwidth
96k	Acceptable	Streaming, mobile apps
128k	Good	Standard streaming, most use cases
192k	High	High-quality streaming
256k	Very High	Premium streaming services
320k	Maximum	Archival, audiophile quality

Use Cases

Podcast Distribution

Convert recordings to MP3 for universal compatibility

Music Streaming

Optimize audio files with Opus or AAC for bandwidth efficiency

Audio Archival

Convert to FLAC for lossless long-term storage

Mobile Apps

Reduce file sizes with lower bitrates for faster downloads

Advanced Options

Lossless Conversion

For lossless formats (FLAC, WAV), omit the bitrate parameter:

{
  "source_bucket": "my-bucket",
  "source_key": "audio.wav",
  "dest_bucket": "my-bucket",
  "dest_key": "audio.flac",
  "format": "flac"
}

High-Quality Conversion

For maximum quality, use the highest bitrate:

{
  "source_bucket": "my-bucket",
  "source_key": "audio.flac",
  "dest_bucket": "my-bucket",
  "dest_key": "audio.mp3",
  "format": "mp3",
  "bitrate": "320k"
}

Batch Processing

Convert multiple audio files at once using Batch Operations:

{
  "jobs": [
    {
      "type": "audio_convert",
      "source_bucket": "my-bucket",
      "source_key": "track1.wav",
      "dest_bucket": "my-bucket",
      "dest_key": "track1.mp3",
      "parameters": { "format": "mp3", "bitrate": "192k" }
    },
    {
      "type": "audio_convert",
      "source_bucket": "my-bucket",
      "source_key": "track2.wav",
      "dest_bucket": "my-bucket",
      "dest_key": "track2.mp3",
      "parameters": { "format": "mp3", "bitrate": "192k" }
    }
  ]
}