// troubleshooting guide · murf ai

Murf API Error 403, 402 or 429

Status
Ongoing
platforms:
API
updated:
November 15, 2026
reports:
2
Method
how we research
Share

RUNBOOK · murf-ai/api-errors5 FIXES

// quick answer

Murf's API returns 403 for an invalid key (not 401), 402 when quota is used up, and 429 when you hit concurrency or rate limits; fix the key, top up, or retry with backoff.

Most likely fix: Check the API key

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Check the API key

    1. 01Send the key in the 'api-key' header
    2. 02Treat 403 and WebSocket close 1008 as auth failures
    Did this fix it?
  2. FIX 2Top up or upgrade quota

    1. 01On 402, add balance or upgrade in the Murf API dashboard
    Did this fix it?
  3. FIX 3Respect rate and concurrency limits

    1. 01On 429 wait for Retry-After and cap in-flight requests
    2. 02Close finished WebSocket contexts with {"end": true}
    Did this fix it?
  4. FIX 4Validate request fields

    1. 01Check voiceId against GET /v1/speech/voices
    2. 02Check model, format and sampleRate values
    Did this fix it?
  5. FIX 5Retry server errors with backoff

    1. 01Retry 500/503 with exponential backoff
    2. 02Fall back to global.api.murf.ai; send the trace_id to support if it repeats
    Did this fix it?

Symptoms

API calls to /v1/speech/generate or /stream fail with 400, 402, 403, 408, 429, 500 or 503; WebSocket closes with 1008 or 4029.

Why it happens

  • C-01Invalid or expired API key (403 / WebSocket 1008)
  • C-02Quota exhausted or subscription expired (402)
  • C-03Too many concurrent requests or contexts (429 / 4029)
  • C-04Invalid voiceId, model, format or sampleRate (400)
  • C-05Server saturation (500/503)

// this guide also covers

  • murf api 403
  • murf api error
  • murf api 429
  • murf api not working

Still not working?

If Murf AI keeps failing, you're not alone. See every Murf AI problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Murf AI Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Murf AI errors

All 14 Murf AI errors and fixes →