Skip to main content

Quick Start

Get up and running with AudioSpliter in under 2 minutes.

Prerequisites​

  • An AudioSpliter account (sign up here)
  • An API key (create one in the dashboard or via the API)

Step 1: Get Your API Key​

Log in to the AudioSpliter Dashboard and navigate to Settings > API Keys. Click Create New Key and copy the key value.

caution

Your API key is shown only once at creation time. Store it securely.

Step 2: Submit a Split Job​

curl -X POST https://api.audiospliter.com/api/v1/splits \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/podcast-episode.mp3",
    "splitMode": "duration",
    "segmentDuration": 600,
    "outputFormat": "mp3",
    "webhookUrl": "https://your-app.com/webhooks/audiospliter"
  }'

Response:

{
  "id": "job_abc123",
  "status": "queued",
  "splitMode": "duration",
  "segmentDuration": 600,
  "outputFormat": "mp3",
  "createdAt": "2026-03-29T10:00:00Z"
}

Step 3: Check Job Status​

curl https://api.audiospliter.com/api/v1/splits/job_abc123 \
  -H "X-API-Key: your_api_key_here"

Response (completed):

{
  "id": "job_abc123",
  "status": "completed",
  "segments": [
    {
      "index": 0,
      "downloadUrl": "https://cdn.audiospliter.com/segments/abc123-0.mp3",
      "duration": 600,
      "size": 9600000
    },
    {
      "index": 1,
      "downloadUrl": "https://cdn.audiospliter.com/segments/abc123-1.mp3",
      "duration": 600,
      "size": 9500000
    },
    {
      "index": 2,
      "downloadUrl": "https://cdn.audiospliter.com/segments/abc123-2.mp3",
      "duration": 180,
      "size": 2900000
    }
  ],
  "completedAt": "2026-03-29T10:01:23Z"
}

Step 4: Download Segments​

Each downloadUrl is a signed URL valid for 24 hours. Download them directly or pass them to your application.

curl -o segment-0.mp3 "https://cdn.audiospliter.com/segments/abc123-0.mp3"

What's Next?​