Handling Large Files

AudioSpliter can process files up to 2 GB on paid plans. Large files require some additional considerations for reliable processing.

File Size Limits by Plan

Plan	Max File Size
Free	100 MB
Starter	500 MB
Pro	2 GB
Enterprise	Custom

Provide a Direct Download URL

For large files, ensure your sourceUrl points to a direct download link -- not a web page or a redirect chain. The URL must:

• Return the audio file directly (not HTML)
• Support HTTP range requests (recommended)
• Be accessible without authentication, or include auth in the URL
• Remain valid for at least 1 hour

Good URLs

https://storage.example.com/files/large-recording.mp3
https://s3.amazonaws.com/bucket/file.mp3?X-Amz-Signature=...

Bad URLs

https://drive.google.com/file/d/abc123/view  (HTML page, not a direct download)
https://example.com/download?token=expired   (expired token)

Use Webhooks for Large Files

Large files take longer to process. Instead of polling, use webhooks to get notified when processing is complete:

curl -X POST https://api.audiospliter.com/api/v1/splits \
  -H "X-API-Key: as_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://storage.example.com/large-file.wav",
    "splitMode": "duration",
    "segmentDuration": 1800,
    "outputFormat": "mp3",
    "webhookUrl": "https://your-app.com/webhooks/audiospliter"
  }'

Processing Times

Approximate processing times for large files:

File Size	Estimated Time
100 MB	30-60 seconds
500 MB	2-5 minutes
1 GB	5-10 minutes
2 GB	10-20 minutes

Times vary based on format, split mode, and server load.

Tips

• Convert to a compressed format during the split (outputFormat: "mp3") to reduce download sizes for segments.
• Monitor progress using the job.progress webhook event for files over 500 MB.
• Set up error handling -- large files are more likely to encounter transient errors. Check for job.failed events and retry if needed.
• Download segments promptly -- signed URLs expire after 24 hours.