elevenlabs-common-errors

# ElevenLabs Common Errors ## Overview Quick diagnostic reference for ElevenLabs API errors organized by HTTP status code, with real error messages, causes, and solutions. ## Prerequisites - ElevenLabs SDK installed - API key configured - Access to error logs or console output ## Instructions ### Step 1: Quick Diagnostic ```bash # Test API connectivity and auth curl -s -w "\nHTTP %{http_code}" \ https://api.elevenlabs.io/v1/user \ -H "xi-api-key: ${ELEVENLABS_API_KEY}" # Check character quota curl -s https://api.elevenlabs.io/v1/user \ -H "xi-api-key: ${ELEVENLABS_API_KEY}" | \ jq '.subscription | {tier, character_count, character_limit}' # List available voices (confirms API access) curl -s https://api.elevenlabs.io/v1/voices \ -H "xi-api-key: ${ELEVENLABS_API_KEY}" | jq '.voices | length' ``` ### Step 2: Error Reference --- #### HTTP 401 — Authentication / Quota **Error: `invalid_api_key`** ```json { "detail": { "status": "invalid_api_key", "message": "Invalid API key" } } ``` **Cause:** API key is missing, malformed, or revoked. **Fix:** ```bash # Verify key is set echo "${ELEVENLABS_API_KEY:0:8}..." # Test with curl curl -s https://api.elevenlabs.io/v1/user -H "xi-api-key: ${ELEVENLABS_API_KEY}" # Regenerate at: https://elevenlabs.io/app/settings/api-keys ``` **Error: `quota_exceeded`** ```json { "detail": { "status": "quota_exceeded", "message": "You have insufficient quota to complete this request" } } ``` **Cause:** Mon...