Agent skill · data analytics · jeremylongshore
elevenlabs-common-errors
Diagnose and fix ElevenLabs API errors by HTTP status code. Use when encountering ElevenLabs errors, debugging failed TTS/STS requests, or troubleshooting voice cloning and streaming issues. Trigger with "elevenlabs error", "fix elevenlabs", "elevenlabs not working", "debug elevenlabs", "elevenlabs 401", "elevenlabs 429", "elevenlabs 400".
Why this skill is useful
Provides specific commands and troubleshooting steps for ElevenLabs API errors that the AI wouldn't reliably generate on its own.
What it needs
Requires elevenlabs-sdk, jq installed locally. Requires elevenlabs account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
ElevenLabs Common Errors Overview Quick diagnostic reference for ElevenLabs API errors organized by HTTP status code: run the connectivity probe, map the observed status code to a fix, then confirm with the debug checklist. This file is the fast index; the full per-error catalog (payloads + code fixes for every status code) lives in references/error-reference.md. Prerequisites ElevenLabs SDK installed API key configured (ELEVENLABSAPIKEY) Access to error logs or console output Instructions Step 1: Quick Diagnostic Run the connectivity probe to isolate auth from quota from request problems: Step 2: Map the Status Code to a Fix Match the HTTP status code (and the detail.status string in the response body) to its row below, then open the linked catalog entry for the exact payload and copy-paste fix: Status detail.status Root cause First move -------- ----------------- ------------ ----------- 401 invalidapikey Key missing/malformed/revoked Re-check ELEVENLABSAPIKEY, regenerate if needed 401 quotaexceeded Monthly character limit hit Check usage, upgrade or enable usage-based billing 400 voicenotfound Bad voiceid in path GET /v1/voices to list valid IDs 400 texttoolong TTS text > 5,000 chars Chunk text with previoustext/nexttext 400 modelnotfound Bad modelid string Use an exact model ID (see catalog) 429 toomanyconcurrentrequests Over plan concurrency Queue requests to your plan limit 429 systembusy ElevenLabs under load Retry with backoff (maxRetries) 422 invalidvoicesample Clone audio bad format/too short MP3/WAV/M4A/FLAC, ≥30s, clean speech — WebSocket fails silently Missing xiapikey / elevenv3 on WS Send key in first WS message, use elevenflashv25 Full payloads, causes, and fix snippets for every row: references/error-reference.md. Step 3: Debug Checklist 1. Verify API key: curl -s https://api.elevenlabs.io/v1/user -H "xi-api-key: $ELEVENLABSAPIKEY" 2. Check quota: Look at charactercount vs characterlimit in the response 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/elevenlabs-common-errors