Error Reference

{
  "error": "Description of what went wrong"
}

{
  "error": {
    "type": "rate_limit_exceeded",
    "message": "Maximum 5 concurrent requests. Retry when a current request completes.",
    "concurrent_limit": 5,
    "concurrent_active": 5
  }
}

import time
import requests

def generate_speech_with_retry(text, voice, max_retries=3):
    """Generate speech with exponential backoff on failure."""
    for attempt in range(max_retries):
        response = requests.post(
            "https://api.murmr.dev/v1/audio/speech",
            headers={
                "Authorization": f"Bearer {API_KEY}",
                "Content-Type": "application/json"
            },
            json={"text": text, "voice": voice}
        )

        if response.status_code == 202:
            return response.json()  # Job submitted

        # Retry on 5xx errors or 429
        if response.status_code >= 500 or response.status_code == 429:
            wait_time = (2 ** attempt) * 2  # 2, 4, 8 seconds
            retry_after = response.headers.get("Retry-After")
            if retry_after:
                wait_time = int(retry_after)
            print(f"Retry {attempt + 1}/{max_retries} in {wait_time}s...")
            time.sleep(wait_time)
            continue

        # Don't retry 4xx client errors (except 429)
        response.raise_for_status()

    raise Exception("Max retries exceeded")

{
  "type": "error",
  "message": "All slots occupied, try again shortly",
  "code": 4006
}