Powerful Audio Processing API Platform

Check API health and job status

# Check API health status
curl http://localhost:8001/api/health

# Get split job status
curl -H "X-API-Key: your-api-key" \
  http://localhost:8001/api/splits/job/{job_id}

# Get upload job status
curl -H "X-API-Key: your-api-key" \
  http://localhost:8001/api/job/{job_id}

# List all jobs (admin only)
curl -H "X-API-Key: admin-api-key" \
  http://localhost:8001/api/splits/jobs

Manage API keys (requires admin privileges)

# Create a new API key
curl -X POST http://localhost:8001/api/keys \
  -H "Content-Type: application/json" \
  -H "X-API-Key: admin-api-key" \
  -d '{"name": "my-app", "description": "Production key"}'

# List all API keys
curl -H "X-API-Key: admin-api-key" \
  http://localhost:8001/api/keys

# Revoke an API key
curl -X POST -H "X-API-Key: admin-api-key" \
  http://localhost:8001/api/keys/{key_id}/revoke

# Delete an API key
curl -X DELETE -H "X-API-Key: admin-api-key" \
  http://localhost:8001/api/keys/{key_id}

Process multiple audio files with async batch job

async function processBatch(audioUrls) {
  // Create async batch job
  const response = await fetch('http://localhost:8001/api/splits/batch/job', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'your-api-key'
    },
    body: JSON.stringify({ audio_urls: audioUrls })
  });

  const { job_id } = await response.json();
  console.log(`Batch job created: ${job_id}`);
  return job_id;
}

// Usage
const jobId = await processBatch(['url1.wav', 'url2.wav']);

Poll for job completion with status updates

async function waitForJob(jobId, onProgress) {
  while (true) {
    const res = await fetch(
      `http://localhost:8001/api/splits/job/${jobId}`,
      { headers: { 'X-API-Key': 'your-api-key' } }
    );
    const job = await res.json();

    // Report progress
    onProgress?.(job.status, job.message);

    if (job.status === 'completed') return job.result;
    if (job.status === 'failed') throw new Error(job.error);

    await new Promise(r => setTimeout(r, 1000));
  }
}

// Usage
const result = await waitForJob(jobId, (status, msg) => {
  console.log(`[${status}] ${msg}`);
});

Poll job status until completion with progress updates

import requests
import time

job_id = "your-job-id"

# Poll for job completion
while True:
    status = requests.get(
        f"http://localhost:8001/api/splits/job/{job_id}",
        headers={"X-API-Key": "your-api-key"}
    ).json()

    print(f"[{status['status']}] {status['message']}")

    if status["status"] == "completed":
        segments = status["result"]["segments"]
        print(f"Done! Found {len(segments)} segments")
        break
    elif status["status"] == "failed":
        print(f"Error: {status['error']}")
        break

    time.sleep(2)  # Poll every 2 seconds

Complete reusable workflow: create job, poll, and return results

import requests
import time

def process_audio_async(audio_url, api_key, poll_interval=1):
    # Process audio file asynchronously and wait for results

    # Create the job
    job = requests.post(
        "http://localhost:8001/api/splits/file/job",
        headers={"X-API-Key": api_key},
        json={"audio_url": audio_url}
    ).json()

    job_id = job["job_id"]
    print(f"Created job: {job_id}")

    # Poll until completion
    while True:
        status = requests.get(
            f"http://localhost:8001/api/splits/job/{job_id}",
            headers={"X-API-Key": api_key}
        ).json()

        if status["status"] == "completed":
            return status["result"]
        elif status["status"] == "failed":
            raise Exception(status["error"])

        time.sleep(poll_interval)

# Usage
result = process_audio_async("https://example.com/audio.wav", "your-key")
print(f"Got {result['count']} segments")