Published 2026-09-21 · Tested 2026-08-20
ElevenLabs
DElevenLabs received 9 PASS votes and passed 3 of five agent surface checks. The clearest finding came from the find the exact limits task.
Three AI models, GPT 5.6 Sol, Claude Opus 5, and DeepSeek v4 Flash, each read ElevenLabs’s public documentation independently and attempted five first-hour developer jobs: generate the first speech audio, find the exact limits, recover from a 429, verify a workspace webhook, use the Python SDK.
No accounts, API calls, or code execution were used. Every verdict came from public pages and every published quotation passed a live verification check.
Freshness
How rechecks work- Category
- Voice & speech
- Tested
- Quotes verified
- Surface rechecked
No change since the test.
5 of 5 quoted passages still appear on the live pages.
66.2% · 53/80 · AI Agent Readiness Score · reading 30 pts · surface 50 pts
Agent surface checks · 30/50
The Reading Test
| Task | GPT 5.6 Sol | Opus 5 | DeepSeek v4F | Consensus |
|---|---|---|---|---|
| Generate the first speech audio | PASS | PASS | PASS | PASS |
| Find the exact limits | PARTIAL | FAIL | PARTIAL | PARTIAL |
| Recover from a 429 | PARTIAL | PARTIAL | PARTIAL | PARTIAL |
| Verify a workspace webhook | PASS | PASS | PASS | PASS |
| Use the Python SDK | PASS | PASS | PASS | PASS |
docs platform: Fern (unscored) · verified 2026-08-20
What to fix first
These 4 fixes could add up to 27 points to the AI Agent Readiness Score. The list ranks each fix by the points it would add. How the ranking works
- 1 +10 points llms-full.txt check failed
Found: HTTP 301 redirects to llms.txt, so no separate full corpus exists.
Fix: Publish llms-full.txt at the docs root with the full text of every docs page in one plain-text file.
Evidence: elevenlabs.io/
docs/ llms-full.txt (opens in a new tab) - 2 +10 points Docs AI check failed
Found: The live Fern configuration disables embedded Ask AI.
Fix: Add an assistant to the docs site that answers questions from the docs and links to its sources.
- 3
Found: No docs page lists per-plan credit quotas, and the 429 article lacks the Flash concurrency limits on the Models page.
Fix: Publish each plan's monthly credits in the docs, and add the Models page's Flash concurrency limits to the 429 article.
- 4
Found: The errors reference names the concurrency 429 concurrent_limit_exceeded, while the help-center 429 article names it too_many_concurrent_requests.
Fix: List the same 429 error codes, including the concurrency code, on the errors reference and the help-center 429 article.
Evidence: elevenlabs.io/
docs/ eleven-api/ resources/ errors (opens in a new tab)
What the docs get right
- Generate the first speech audio: 3 PASS votes. The quickstart covers key creation, installation, environment loading, conversion, playback, and execution in one sequence.
- Verify a workspace webhook: 3 PASS votes. The guide documents HMAC creation and verification; the API HTML URL returned 401, while its Markdown mirror loaded.
- 3 of 5 agent surface checks. Present: llms.txt, markdown mirrors, an MCP server. Missing: llms-full.txt, docs AI.
Generate the first speech audio
PASSPASS consensus from 3 PASS.
The quickstart covers key creation, installation, environment loading, conversion, playback, and execution in one sequence. The quickstart gives one linear path with a direct dashboard link for the key, pip install elevenlabs, a complete runnable Python snippet with a working voice ID, and a run command; saving to an .mp3 file is covered in the streaming guide linked from Next steps. The quickstart provides a four-step path (create API key, install SDK, write code, run) with a complete working example including import statements and the play() call.
Find the exact limits
PARTIALPARTIAL consensus from 2 PARTIAL, 1 FAIL.
The 429 page gives unscoped plan concurrency values, while Models adds doubled Flash limits; two alternative concurrency URLs failed. No page in the documentation publishes a per-plan monthly credit quota (the billing page defers to the off-docs pricing page, and the only quota figure anywhere is an incidental "30,000" in the rollover article), while the Text to Speech concurrency values and the per-request character limits each appear on two pages that disagree; the sentence quoted above also says five plans and then names six. Monthly credit quotas (10K/30K/121K/600K/1.8M/6M) are only on the interactive pricing comparison table, not in a docs page. Concurrency and per-request limits are well documented. Rollover rules contradict: the main docs page says all credits roll over up to two months, while the help center page says credit rollover does not apply to accounts on the free tier.
Recover from a 429
PARTIALPARTIAL consensus from 3 PARTIAL.
The general guide gives both corrections, but its 429 labels differ from the dedicated 429 page. The errors reference cleanly separates the two 429 causes and prescribes exponential backoff for rate limiting and waiting for in-flight requests for concurrency, but the help-center 429 article names the concurrency error too_many_concurrent_requests instead of concurrent_limit_exceeded, so an agent branching on the error string picks the wrong constant depending on which page it read. The three 429 error types (rate_limit_exceeded, concurrent_limit_exceeded, system_busy) are clearly distinguished with type classifications and actionable guidance. However, no documented retry behavior exists, no Retry-After header, no exponential backoff recommendation, no SDK example for handling rate limit errors.
Verify a workspace webhook
PASSPASS consensus from 3 PASS.
The guide documents HMAC creation and verification; the API HTML URL returned 401, while its Markdown mirror loaded. The create endpoint takes auth_type "hmac" and returns webhook_secret, and the FastAPI example reads the raw body, passes it with the elevenlabs-signature header to construct_event, returns 401 on failure and 200 on success; the raw signature encoding is not documented, so verification without an official SDK is not possible from these pages. The webhook verification process is fully documented: HMAC signature setup, SDK construct_event method (Python and JS), required header verification, raw body requirement, HTTP 200 response, and idempotency guidance. Complete FastAPI example provided.
Use the Python SDK
PASSPASS consensus from 3 PASS.
The Python example installs the SDK, sets the key, and sends REST-aligned text, voice, model, and format fields. The Python SDK arguments map one to one onto the documented REST path parameter, query parameter, and body fields on the same page, and the client construction matches the authentication page, though the import is written from elevenlabs import ElevenLabs here and from elevenlabs.client import ElevenLabs in the quickstart. The SDK installation command, client initialization with API key, and text-to-speech convert method all match the REST API reference (convert endpoint). The example uses the same parameters (text, voice_id, model_id, output_format) documented in the API reference.
The receipt
Monthly price and included credits per plan: Free $0 (10,000 credits); Starter $6 (30,000 credits); Creator $22 (121,000 credits, $11 for the first month); Pro $99 (600,000 credits); Scale $299 (1,800,000 credits, 3 seats); Business $990 (6,000,000 credits, 10 seats); Enterprise is custom.
The 429 page gives unscoped plan concurrency values, while Models adds doubled Flash limits; two alternative concurrency URLs failed.
Agent surface notes
Initialize returned a valid MCP response with Fern Docs server information.
The live Fern configuration disables embedded Ask AI.
Show the score
Paste this into a readme:
[](https://docsforagents.com/reports/elevenlabs-docs-ai-agent-readiness/) Method note
This is a reading test of public documentation, not an execution test. No accounts were created and no API calls were run. The AI Agent Readiness Score counts fifteen reading votes at PASS 2, PARTIAL 1, and FAIL 0, for 30 possible points. Five agent surface checks add 10 points each. The total is 80. Consensus chips show each row majority and do not affect scoring. The panel split on 1 of five tasks. Quotes shown here were re-fetched and confirmed verbatim on 2026-08-20.
Put another docs site through the battery.
Nominate a docs site