API: published rate & concurrency limits, and a docs_url on 429s
API: published rate & concurrency limits, and a docs_url on 429s
The API limits reference now lists the per-plan rate limits (sustained requests per second, plus a burst allowance on Agents) and concurrency limits (simultaneous in-flight requests) for every plan, across both the audio (TTS) and Agents surfaces. Limits apply per account, not per API key.
429 Too Many Requests responses are now self-describing:
- A
Retry-Afterheader tells you when to retry. - The error
codedistinguishes the two cases:rate_limited(too many requests per second) versusconcurrency_limited(too many simultaneous requests). - The error envelope carries a
docs_urlthat links straight to the limits reference, which lists your plan’s limits and how to raise them.
Rate and concurrency limits rise with your plan, and Enterprise limits are starting points rather than hard caps.